Skip to main content

SSH Key Setup

SSH access requires key-based authentication. This guide walks you through generating and adding your SSH key.

1. Generate an SSH Key​

If you don't already have an SSH key, generate one:

ssh-keygen -t ed25519 -C "[email protected]"

Press Enter to accept the default file location. You can optionally set a passphrase for additional security.

This creates two files:

  • ~/.ssh/id_ed25519 - Your private key (keep this secret!)
  • ~/.ssh/id_ed25519.pub - Your public key (this gets added to the dashboard)

2. Add Your Key to the Dashboard​

  1. Copy your public key:

    cat ~/.ssh/id_ed25519.pub

  2. Go to your site in the Urumi Dashboard

  3. Navigate to Settings → SSH/SFTP

  4. Click Add SSH Key

  5. Paste your public key and give it a name (e.g., "Work Laptop")

3. Test the Connection​

ssh [email protected] 'echo "Connected!"'

You should see Connected! printed. If you get an error, see Troubleshooting.

Using Multiple Keys​

If you have multiple SSH keys, you can specify which one to use:

ssh -i ~/.ssh/my-other-key [email protected] 'wp --version'

Or configure it in ~/.ssh/config:

Host ssh.myscalablesite.com
    IdentityFile ~/.ssh/id_ed25519
    User mysite-staging

Then simply run:

ssh ssh.myscalablesite.com 'wp --version'

Loading Your Key​

If you set a passphrase, you'll need to load your key into the SSH agent:

# Start the SSH agent (if not running)
eval "$(ssh-agent -s)"

# Add your key
ssh-add ~/.ssh/id_ed25519

You'll be prompted for your passphrase once, and then the key will be cached for the session.