homelab-agents/SSH-SETUP.md

SSH Setup for Gitea

To push code to Gitea from your VPS, you need to set up SSH authentication.

Generate SSH Key

On your VPS, run:

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ""

This creates:

• ~/.ssh/id_ed25519 (private key)
• ~/.ssh/id_ed25519.pub (public key)

Add Public Key to Gitea

1. Display your public key:

   cat ~/.ssh/id_ed25519.pub
   

2. Copy the output (entire line starting with ssh-ed25519)

3. Go to Gitea: http://100.120.125.113:3000/user/settings/keys

4. Click "Add Key"

5. Paste your public key

6. Click "Add Key"

Test SSH Connection

Verify it works:

ssh -T git@100.120.125.113

You should see a message like:

Hi pdm! You've successfully authenticated, but Gitea does not provide shell access.

Using SSH with Git

When you init-project, it automatically sets up SSH remotes:

init-project my-app
cd my-app
git remote -v
# Should show: origin git@100.120.125.113:pdm/my-app.git (fetch)

Now when you push:

git push origin main

No password needed - SSH key handles authentication!

Troubleshooting

SSH key not being used:

# Check SSH agent is running
eval "$(ssh-agent -s)"

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

Still getting authentication errors:

1. Verify key is in Gitea (http://100.120.125.113:3000/user/settings/keys)
2. Check file permissions: chmod 600 ~/.ssh/id_ed25519
3. Test connection: ssh -T git@100.120.125.113

Need different key per VPS: Generate separate keys:

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_vps-name -N ""

Add to Gitea with a descriptive name (e.g., "vps-name-key")

One-Time Setup Script

To automate this on a new VPS:

#!/bin/bash
# Auto-setup SSH for Gitea
mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ""
echo ""
echo "✅ SSH key generated!"
echo "Add this to Gitea (http://100.120.125.113:3000/user/settings/keys):"
cat ~/.ssh/id_ed25519.pub
echo ""
echo "Test with: ssh -T git@100.120.125.113"

Save as ~/.homelab-scripts/setup-ssh.sh and run: bash ~/.homelab-scripts/setup-ssh.sh