Instances

Connect to an instance

Work on your instance from the browser, your own terminal or your IDE, without losing your session.

This page covers the three ways to open a shell on a running instance, and how to keep work running when you disconnect.

MethodNeedsBest for
Browser terminalNothingQuick access from any browser.
SSHAn SSH key and an image that can run an SSH serverYour own terminal, IDE remote development, scp and rsync.
CLIThe CLI, signed inScripts, and a shell without an SSH key.

Open the browser terminal

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.

Connect with SSH

Add an SSH key

Add your public key on the Credentials page. See SSH keys.

Copy the SSH command

The instance's Connect tab shows the SSH command once SSH is ready:

ssh <instance-id>@ssh.cloud.featherless.ai

Connect

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.

Keep programs running with tmux

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.

tmux sessions end when the instance stops or restarts.

Open a shell from the CLI

instance shell opens the same shell as the browser terminal, without an SSH key:

featherless-cloud instance shell my-instance

Next steps

Expose ports

Reach web apps and APIs over HTTPS.

Transfer files

Move data in and out of network volumes.