From ef54332fe884da5627b3f8b6f625f853158c167c Mon Sep 17 00:00:00 2001
From: adtpdn <adtpdn@gmail.com>
Date: Thu, 2 Jul 2026 01:46:24 +0800
Subject: [PATCH] Add SSH setup wiki pages

---
 SSH-Setup-Linux.md   | 36 ++++++++++++++++++++++++++++++++++++
 SSH-Setup-Windows.md | 42 ++++++++++++++++++++++++++++++++++++++++++
 SSH-Setup-macOS.md   | 35 +++++++++++++++++++++++++++++++++++
 3 files changed, 113 insertions(+)
 create mode 100644 SSH-Setup-Linux.md
 create mode 100644 SSH-Setup-Windows.md
 create mode 100644 SSH-Setup-macOS.md

diff --git a/SSH-Setup-Linux.md b/SSH-Setup-Linux.md
new file mode 100644
index 0000000..4cd60ab
--- /dev/null
+++ b/SSH-Setup-Linux.md
@@ -0,0 +1,36 @@
+# SSH Setup — Linux
+
+## Generate an SSH key
+Open a terminal and run:
+```bash
+ssh-keygen -t ed25519 -C "your-name@example.com"
+```
+Press Enter to accept the default path `/home/<you>/.ssh/id_ed25519`. Use a passphrase for extra safety.
+
+## Add the public key to Gitea
+```bash
+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: `linux-<yourname>`.
+
+## Accept the server fingerprint and test
+```bash
+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 linux-<yourname>, but Gitea does not provide shell access.`
+
+## Clone a repo
+```bash
+git clone git@thunderobot:222/danchie/tekton.git
+```
+Or with tea:
+```bash
+tea repos clone --git-protocol ssh danchie/tekton
+```
+
+## Troubleshooting
+- **`Permission denied (publickey)`** — Your key wasn't added in the Gitea UI, or the agent hasn't loaded it. 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`.
+- **`ssh: Could not resolve hostname thunderobot`** — Run `tailscale ping thunderobot` to verify tailnet DNS works. If not, use `ssh -T git@100.93.226.13 -p 222` instead.
diff --git a/SSH-Setup-Windows.md b/SSH-Setup-Windows.md
new file mode 100644
index 0000000..9a52876
--- /dev/null
+++ b/SSH-Setup-Windows.md
@@ -0,0 +1,42 @@
+# SSH Setup — Windows
+
+## Install Git for Windows
+Download from https://git-scm.com/download/win and install with default options.
+
+This installs `git`, `ssh`, and `git-bash`.
+
+## Generate an SSH key
+Open **Git Bash** and run:
+```bash
+ssh-keygen -t ed25519 -C "your-name@example.com"
+```
+Press Enter to accept the default path `C:\Users\<you>\.ssh\id_ed25519`. Set a passphrase, or leave it empty.
+
+## Add the public key to Gitea
+```bash
+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: `windows-<yourname>`.
+
+## Accept the server fingerprint and test
+```bash
+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 windows-<yourname>, but Gitea does not provide shell access.`
+
+If you get this message, the key is recognized.
+
+## Clone a repo
+```bash
+git clone git@thunderobot:222/danchie/tekton.git
+```
+Or with tea:
+```bash
+tea repos clone --git-protocol ssh danchie/tekton
+```
+
+## Troubleshooting
+- **`Permission denied (publickey)`** — Your key wasn't added in the Gitea UI, or `~/.ssh/id_ed25519` isn't being offered. Run `ssh-add ~/.ssh/id_ed25519` in Git Bash.
+- **`Host key verification failed`** — Run the `ssh -T` command above interactively at least once.
+- **`ssh: connect to host thunderobot port 222: Connection refused`** — Ensure you can reach the tailnet host: `ping 100.93.226.13`. If ping fails, your machine isn't on the tailnet.
diff --git a/SSH-Setup-macOS.md b/SSH-Setup-macOS.md
new file mode 100644
index 0000000..fc406c3
--- /dev/null
+++ b/SSH-Setup-macOS.md
@@ -0,0 +1,35 @@
+# SSH Setup — macOS
+
+## Generate an SSH key
+Open **Terminal** and run:
+```bash
+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
+```bash
+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
+```bash
+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
+```bash
+git clone git@thunderobot:222/danchie/tekton.git
+```
+Or with tea:
+```bash
+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`.