Troubleshooting
SSH refused
Messages from adding a key, from the SSH gateway and from your own SSH client.
Updated
Connecting over SSH takes two things: a public key added under Settings, SSH keys, and the command shown on the Terminal page under "Connect with SSH" for a running service. The messages below come from adding the key, from the gateway itself, and from your own SSH client. For the setup, see SSH access or the SSH tutorial.
Adding a key
These appear under the Public key or Name field of the "Add an SSH key" dialog.
| Message | Why | What to do |
|---|---|---|
| Paste a public key, the single line in a file such as ~/.ssh/id_ed25519.pub. | The Public key field is empty. | Paste the contents of your .pub file. |
| That is a private key. Paste the public key from the .pub file, and keep the private key to yourself. | The pasted text is a private key. | Paste the file that ends in .pub instead, and keep the private key on your machine. |
| That is not an OpenSSH public key. Paste the single line from the .pub file. | The text is not one OpenSSH key line: it spans several lines, is cut short, or is in another format. | Paste the whole single line, such as the output of cat ~/.ssh/id_ed25519.pub. |
| Cloud accepts Ed25519, ECDSA and RSA keys of at least 2048 bits. | The key is of a type Cloud does not take, such as DSA, or an RSA key shorter than 2048 bits. | Create a new key with ssh-keygen -t ed25519 and add its .pub file. |
| That key is already added to a Cahaves Cloud account. | A key can belong to one account only, and this one already does, possibly yours. | Check the list on SSH keys. To use the key here, remove it from the other account first, or create a new key. |
| An account holds at most 20 keys. Remove one first. | Your account already has 20 keys. | Remove a key you no longer use; Last used helps find one. |
| Give the key a name. | The Name field is empty. | Give a short name, such as the machine the key lives on. |
| Give the key a name of 1 to 64 characters. | The Name is longer than 64 characters. | Shorten it. |
When you connect
When the shell closes
A shell opened over SSH ends with the same sentences as the web terminal, printed before your client returns: "Nothing is running.", "Closed after 30 minutes idle.", "Too many open connections. Close one and try again." and the others in Logs and terminal closed. An SSH session counts toward the same limit of open connections as log streams and web terminals.
Removing a key stops new connections with it; a shell already open with it stays open until it ends.