How to add an SSH key and connect to your account with SSH

For hosting customers · Updated 2026-10-29

On this page
  1. Before you start
  2. Create a key on your computer (if you have none)
  3. Add the key
  4. Connect
  5. Good to know
  6. Common questions

An SSH key lets you sign in without typing your password. It is safer than a password and many deployment tools need it. Keys work for the command line (SSH) and for file transfer (SFTP).

Before you start

  • To get a command line, your plan needs shell access. SSH Access shows it under Access: SSH terminal and SFTP, or SFTP (file transfer) only.

Create a key on your computer (if you have none)

On macOS, Linux or Windows 10 and later, open a terminal and run:

ssh-keygen -t ed25519

Press Enter to accept the file name, and choose a passphrase. The public key is in ~/.ssh/id_ed25519.pub. Never share the other file, ~/.ssh/id_ed25519 — it is your private key.

Add the key

  1. Log in to the control panel (https://<server>:2083).
  2. Open SSH Access in the menu (section Files).
  3. Under Add a public key, enter a Name, for example My laptop.
  4. Paste the content of ~/.ssh/id_ed25519.pub into Public key. It starts with ssh-ed25519.
  5. Click Add key.

The key appears under Keys with its type and fingerprint.

Connect

Use the Server, Port and Username shown under Connection on the same page:

ssh [email protected]

For file transfer only:

sftp [email protected]

Good to know

  • Accepted keys: ed25519 (recommended), RSA of 2048 bits or more, ECDSA, and ed25519 security keys ([email protected]).
  • Up to 20 keys per account. Click Remove to revoke a key, for example for a lost laptop.
  • Without keys you sign in with your control panel password.
  • Your SSH session sees only your own files and processes. Commands run within your plan's processor, memory and process limits.
  • If your plan has no shell access, the same key works for SFTP.

Common questions

Why do I get "Paste a public key that starts with ssh-ed25519, ssh-rsa or ecdsa-sha2-…"?

You pasted something else, often the private key. Paste the content of the .pub file, on one line.

Why is my RSA key refused?

RSA keys must have at least 2048 bits. Create an ed25519 key with ssh-keygen -t ed25519.

Can I use a command line without installing anything?

Yes, if your plan has shell access: open the browser terminal.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.