Connecting to Volumes

Cycle's integrated remote access provides a convenient way to access persistent volumes attached to an instance regardless of whether they are public or not.

Volumes attached to an instance have the option of enabling remote access SFTP, giving you the ability to connect using an ordinary SFTP client to manage files directly. Remote access must be enabled before you can connect, and per Cycle's security philosophy, is disabled by default.

To enable remote access, follow this guide.

It's important to note that Cycle does NOT install SFTP into your container, or modify it in any way. A secure socket connection is created between CycleOS on your servers, and the central Cycle platform. The central platform creates an SFTP endpoint that your client connects to, ensuring no unnecessary security vulnerabilities are created.

Accessing Volume Information

To see the list of volumes attached to an instance, follow these steps:

  1. Click the Environments tab on the navigation menu to the left.
  2. Select the environment the container instance you want to access is in.
  3. Click the Containers tab under the environment name.
  4. Select the container from the list.
  5. Click the Instances tab under the container name.
  6. Select the specific instance you want to view from the list.

One thing you might notice in this image is the volume size. It says 925MB as the maximum. This is due to the need for an index on each volume that communicates with the underlying OS and says where things are. So in this case a 1GB volume becomes a 925MB volume to accommodate the index.

Viewing Connection Information

If the volume has remote access enabled, a button called SFTP Details will appear on the table. Click it to open a modal containing the remote access information.

In the bottom right of the modal, you'll see the button "Open in SFTP Application". Click this button to automatically launch an SFTP program installed on your computer (such as FileZilla). If your password type is set to "Raw", you will automatically be logged in! For other password types, your SFTP client will most likely ask you for a password. Be sure to enter your actual, non-hashed password.

If your computer is not set up with a default SFTP application, simply copy and paste the values from the modal into your FTP client.

Further Reading

For more detailed information about remotely accessing your containers, check out this blog post or the container FAQ.

Need Help?

If you've got questions about the platform or need some help getting started, our team is more than happy to assist. Whether you're new to containers or just new to Cycle, reach out to us via livechat by clicking the blue circle in the bottom right corner. Join our Slack channel, and get help from the dev team or other members of the community, and check out our Roadmap to see what's planned for the future!