macOS

Connect from macOS

macOS has SSH built in. Open Terminal and go.

Open Terminal

• Spotlight: Cmd + Space, type Terminal, press Enter
• Finder: Applications → Utilities → Terminal

Password Login

ssh root@192.0.2.1

Replace 192.0.2.1 with your actual IP. Custom port:

ssh -p 2222 root@192.0.2.1

First time? Type yes when asked about the host fingerprint. Then type your password. Nothing shows on screen while you type.

SSH Key Login

If you selected an SSH key when installing the OS, password login is disabled. Connect with your key instead.

Generate a Key

ssh-keygen -t ed25519

Press Enter to accept the default path (~/.ssh/id_ed25519). Set a passphrase or press Enter to skip.

This creates:

• ~/.ssh/id_ed25519: private key (never share)
• ~/.ssh/id_ed25519.pub: public key (goes on the server)

Add the Key to QDE

1. Copy your public key:

cat ~/.ssh/id_ed25519.pub | pbcopy

This copies it to your clipboard.

2. Go to cloud.qde.com/sshkeys
3. Click Add Key, paste, give it a name
4. Select this key when you install or reinstall an OS

Connect with Your Key

Default key path: SSH finds it automatically:

ssh root@192.0.2.1

Specific key file:

ssh -i ~/.ssh/my_key root@192.0.2.1

Using a Key Generated in the Control Panel

If you generated a key pair at cloud.qde.com/sshkeys and downloaded the OpenSSH format:

1. Move the key file and set permissions:

mv ~/Downloads/downloaded_key.key ~/.ssh/
chmod 600 ~/.ssh/downloaded_key.key

2. Connect:

ssh -i ~/.ssh/downloaded_key.key root@192.0.2.1

Common Mistakes

Next Steps