1

SSH Setup macOS

adtpdn edited this page 2026-07-02 01:46:24 +08:00

Table of Contents

• SSH Setup — macOS
• Generate an SSH key
• Add the public key to Gitea
• Accept the server fingerprint and test
• Clone a repo
• Troubleshooting

SSH Setup — macOS

Generate an SSH key

Open Terminal and run:

ssh-keygen -t ed25519 -C "your-name@example.com"

Press Enter to accept the default path /Users/<you>/.ssh/id_ed25519. Use a passphrase for extra safety.

Add the public key to Gitea

cat ~/.ssh/id_ed25519.pub

Copy the full output, then open http://git.klud.top/user/settings/keys in your browser and paste it. Title: macos-<yourname>.

Accept the server fingerprint and test

ssh -T git@thunderobot -p 222

• If asked Are you sure you want to continue connecting (yes/no/[fingerprint])?, type yes.
• Expected output: Hi there, <yourname>! You've successfully authenticated with the key named macos-<yourname>, but Gitea does not provide shell access.

Clone a repo

git clone git@thunderobot:222/danchie/tekton.git

Or with tea:

tea repos clone --git-protocol ssh danchie/tekton

Troubleshooting

• Permission denied (publickey) — Your key wasn't added in the Gitea UI, or the key isn't loaded in the agent. Run ssh-add ~/.ssh/id_ed25519.
• Host key verification failed — Run the ssh -T command above interactively at least once.
• ssh: connect to host thunderobot port 222: Connection refused — Ensure Tailscale is running and you can reach 100.93.226.13.