Connect to a Launch server: SSH and the console
Through Rig, with your own key or both. Add keys, use the web console, and reset the root password.
Applies to · Cloud · Mac · ~5 min
You choose how to connect to a Launch server when you order it, and you can change it any time from the server’s Access tab. Password login is always off, and the web console is always there, whichever option you choose.
Three ways to connect
- Through Rig. Connect from Rig on your Mac. There are no keys to manage, and port 22 stays closed to the internet.
- With my SSH key. Normal SSH with your own key, from anywhere.
- Both. The two together.
The Access tab has a copy button for the exact SSH command for your server. It looks like this:
ssh root@coffee-club.rig.app
Add an SSH key
Keys are used when you connect With my SSH key or Both. Add them at checkout, under Advanced, or later in Access, in any of these ways:
- Paste a key. Paste your public key. On a Mac, copy it with
pbcopy < ~/.ssh/id_ed25519.pub. If you don’t have one yet, make one withssh-keygen -t ed25519. - From GitHub. Type a GitHub username and pick from the public keys GitHub lists for it.
- Saved keys. Tick keys you have already saved on your account. Keys saved under Launch → SSH keys are added to new servers by default.
Rig accepts ed25519, ECDSA and RSA keys of 3072 bits or more, and tells you plainly why it refuses anything else. Each key shows its name and fingerprint. Changes apply in seconds, and removing a key removes it from every server it was on. You get an email whenever a key is added.
On a team server, each member adds their own keys. When someone leaves the team, their keys are removed from the team’s servers.
The web console
Choose Console in the server’s header to open a terminal in your browser. It works even when SSH is broken, for example after a firewall change or a bad sshd setting, so you are never locked out.
Lost your key
Open the web console, or add a new key from the Access tab. Either way you are back in within a minute.
Reset the root password
Choose Reset root password in Access. You confirm with your two-factor code, and the new password is shown once. It is never emailed and Rig doesn’t keep a copy, so store it somewhere safe straight away.
Rescue mode
If the server won’t boot, start it in rescue mode from Access. It boots a small recovery system with your disk attached, so you can fix files and then restart normally.