DocsSSH Setup

SSH Setup

Connect to NiveeHub over SSH for passwordless, secure Git operations.

Generate an SSH key

bash
# Generate a new ED25519 SSH key
ssh-keygen -t ed25519 -C "your@email.com"

# When prompted, press Enter to accept the default location
# Then enter a secure passphrase (recommended)

# Start the ssh-agent
eval "$(ssh-agent -s)"

# Add your key to the agent
ssh-add ~/.ssh/id_ed25519

Copy your public key

Copy the contents of your public key — this is what you'll add to NiveeHub.

bash
cat ~/.ssh/id_ed25519.pub | pbcopy
Note: Always share your public key (id_ed25519.pub), never your private key.

Add SSH key to NiveeHub

  1. Log in to NiveeHub
  2. Go to Settings → SSH Keys
  3. Click Add SSH Key
  4. Paste your public key and give it a descriptive title
  5. Click Save

Test your connection

Verify that your SSH key is working correctly.

bash
ssh -T git@niveehub.com

You should see a message like:

text
Hi username! You've successfully authenticated, but NiveeHub does not provide shell access.

Clone over SSH

Use the SSH URL format for your repositories.

bash
# SSH clone format
git clone git@niveehub.com:username/repo-name.git

# Push to SSH remote
git remote set-url origin git@niveehub.com:username/repo-name.git
git push

Troubleshooting

Permission denied (publickey)

Make sure your SSH key is added to the ssh-agent and the public key is added to your NiveeHub account. Run `ssh-add -l` to list loaded keys.

Could not resolve hostname

Check that you're using the correct hostname. For self-hosted instances, use your server's domain or IP address.

Connection refused

Ensure the SSH server is running on port 22 (or the configured port). Check your firewall rules.