From 6adf2a37fe18784bad41836625990c94953cf02f Mon Sep 17 00:00:00 2001 From: jgitta Date: Sun, 14 Jun 2026 22:07:08 -0500 Subject: [PATCH] docs: document gitea SSH push methodology --- README.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/README.md b/README.md index cfecb86..27804d8 100644 --- a/README.md +++ b/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 |