How to add an SSH key and connect to your account with SSH
On this page
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
- Log in to the control panel (
https://<server>:2083). - Open SSH Access in the menu (section Files).
- Under Add a public key, enter a Name, for example
My laptop. - Paste the content of
~/.ssh/id_ed25519.pubinto Public key. It starts withssh-ed25519. - 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.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- How to use the terminal in your browser (SSH without a client)
Open a command line for your hosting account in the browser with Terminal, what you can run there, and the time and session limits that apply.
- FTP and SFTP connection settings (ports, FTPS, FileZilla)
The server, port, username and encryption to connect with FileZilla, WinSCP or Cyberduck over FTP with TLS (port 21) or SFTP (port 22).
- How to deploy a website from GitHub or GitLab with Git
Connect a GitHub, GitLab or Bitbucket repository, add the deploy key for private repos, deploy with a button or a push webhook, and run composer after deploy.