docs: document gitea SSH push methodology

2026-06-14 22:07:08 -05:00
parent f334737c4a
commit 6adf2a37fe
1 changed files with 26 additions and 0 deletions
@@ -130,6 +130,32 @@ siklos to manage all three Docker hosts from one UI.
  is stable and the endpoint is fully functional. Agent data is persisted in the
  `portainer_agent_data` Docker named volume so TLS certs survive restarts.

+## Git / Gitea Push Methodology
+
+Gitea runs as a Docker container on **siklos** (`192.168.88.27`), SSH on port **2222**.
+
+Pushes use SSH key auth (not HTTPS/password). The `~/.ssh/config` entry on any machine that needs to push:
+
+```
+Host gitea
+    HostName 192.168.88.27
+    Port 2222
+    User git
+    IdentityFile ~/.ssh/id_ed25519
+    IdentitiesOnly yes
+    PreferredAuthentications publickey
+```
+
+The remote URL for this repo:
+```bash
+git remote set-url origin gitea:jgitta/homelab-configs.git
+```
+
+To add a new machine's SSH key to Gitea:
+1. Copy the machine's public key: `cat ~/.ssh/id_ed25519.pub`
+2. Paste it at **https://gitea.jgitta.com/user/settings/keys**
+3. Add gitea to `~/.ssh/known_hosts`: `ssh-keyscan -p 2222 192.168.88.27 >> ~/.ssh/known_hosts`
+
 ## Proxmox / Infrastructure Notes

 | Item | Details |