What an SSH key is
An SSH key is a pair of files that work together:
- The private key stays on your computer. Never share it, email it or paste it anywhere.
- The public key goes on the server. It's safe to share: on its own it can't log in to anything.
When you connect, the server checks that your computer holds the private key that matches. No password crosses the internet, and nobody can guess their way in. That's why keys are much safer than passwords for servers.
Which type to create
Choose ed25519. It's short, fast and secure. GOLDNET Cloud accepts public keys that start with ssh-ed25519, ssh-rsa (at least 2048 bits; use 4096) or ecdsa-sha2-....
Create a key on Windows 10 or 11
Windows has SSH built in. Open PowerShell and run:
ssh-keygen -t ed25519 -C "my-laptop"
- Press Enter to accept the suggested location (
C:\Users\<you>\.ssh\id_ed25519). - Type a passphrase. It protects the key if your laptop is ever lost or stolen.
- Show the public key so you can copy it:
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
Note: If you use PuTTY, create the key in PuTTYgen and copy the public key from the box at the top that starts with ssh-ed25519. That OpenSSH format is the one GOLDNET Cloud needs, not the .ppk file.
Create a key on macOS or Linux
Open Terminal and run:
ssh-keygen -t ed25519 -C "my-laptop"
Accept the location (~/.ssh/id_ed25519), set a passphrase, then show the public key:
cat ~/.ssh/id_ed25519.pub
Add the key to GOLDNET Cloud
GOLDNET Cloud opens to the public soon; until then, request access. Once you have an account:
- Copy the whole public key line. It starts with
ssh-ed25519and ends with the comment you gave it. - In GOLDNET Cloud, open SSH keys and add it, or paste it while you deploy a server.
- Choose the key when you deploy. The server is created with it already in place.
Then connect:
ssh root@your-server-ip
If you saved the key somewhere other than the default place, point to it with -i, for example ssh -i ~/.ssh/work_key root@your-server-ip.
Adding more keys later
Each person, and each computer, should have its own key. To give someone access to a server that's already running, add their public key as a new line in ~/.ssh/authorized_keys for the user they log in as. To take access away, delete their line.
Lost your key?
Don't panic. Open the server's browser console in GOLDNET Cloud, or use reset root password, then add a new public key to ~/.ssh/authorized_keys. If you can't get in at all, rescue mode lets you reach the disk.
Keep your keys safe
- Use a passphrase, and let your computer's SSH agent remember it so you don't type it every time.
- Never copy your private key onto a server or into a chat.
- One key per computer. When a laptop is retired, remove its key from your servers.
- Pair keys with a cloud firewall that only allows SSH from your own address: Cloud firewalls: the basics.