docs: document gitea SSH push methodology

README.md

@@ -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 |