This page covers the three ways to open a shell on a running instance, and how to keep work running when you disconnect.
| Method | Needs | Best for |
|---|---|---|
| Browser terminal | Nothing | Quick access from any browser. |
| SSH | An SSH key and an image that can run an SSH server | Your own terminal, IDE remote development, scp and rsync. |
| CLI | The CLI, signed in | Scripts, and a shell without an SSH key. |
The instance's Terminal tab opens a shell in a tmux session named default, so your work keeps running if you close the tab or lose your connection. The session menu opens or creates other named sessions.
The terminal closes after 30 minutes without activity. Processes in its tmux session keep running.
Add your public key on the Credentials page. See SSH keys.
The instance's Connect tab shows the SSH command once SSH is ready:
ssh <instance-id>@ssh.cloud.featherless.ai
Run the command in your terminal. You log in as root.
The CLI can build the command for you, using your SSH config and agent:
featherless-cloud instance ssh my-instance
featherless-cloud instance ssh my-instance -i ~/.ssh/work_ed25519
SSH works with official templates. For a custom image, it works when the image runs as root and includes an SSH server, or a package manager (apt, dnf, yum, apk or zypper) that can install one. The browser terminal works with any image.
Every instance has a tmux session named default, shared with the browser terminal. To attach to it from your computer:
featherless-cloud instance tmux my-instance
featherless-cloud instance tmux my-instance training
The second command attaches to, or creates, a session named training. Detach with Ctrl-b d.
To put every SSH login in the default session automatically, switch on Auto start tmux in SSH sessions when you deploy or edit the instance.
instance shell opens the same shell as the browser terminal, without an SSH key:
featherless-cloud instance shell my-instance