From 1b4838504b56463d8d03bd4fd014aafc832527b7 Mon Sep 17 00:00:00 2001 From: Fizzlepoof Date: Wed, 13 May 2026 17:15:39 +0000 Subject: [PATCH] docs(gitea): document internal SSH remote Record the working internal Gitea SSH remote as ssh://git@10.5.1.6:2222//.git and replace stale HTTPS/gitea.paccoco.com examples for PD/NOMAD operations. Port 2222 is SSH, while the web UI remains on port 3002. --- docs/architecture/ARCHITECTURE_OVERVIEW.md | 4 ++-- docs/architecture/SERVICES_DIRECTORY.md | 2 +- docs/operations/SECRETS_MANAGEMENT.md | 2 +- docs/operations/STACK_STANDARDS.md | 7 +++++-- 4 files changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/architecture/ARCHITECTURE_OVERVIEW.md b/docs/architecture/ARCHITECTURE_OVERVIEW.md index f43bde2..98377b8 100644 --- a/docs/architecture/ARCHITECTURE_OVERVIEW.md +++ b/docs/architecture/ARCHITECTURE_OVERVIEW.md @@ -24,7 +24,7 @@ Full homelab stack as of 2026-05-09. All 6 expansion phases are complete and dep - **Homepage** (3300) — dashboard / service index - **Uptime Kuma** (3001) — monitoring and alerting - **Gotify** (8443) — push notifications -- **Gitea** (3002) — self-hosted git +- **Gitea** (3002 web / 2222 SSH) — self-hosted git; internal SSH remote uses `ssh://git@10.5.1.6:2222//.git` - **Dockhand** (3230) — Docker management UI ### AI Layer @@ -61,4 +61,4 @@ Full homelab stack as of 2026-05-09. All 6 expansion phases are complete and dep 3. **External Docker networks** — `ai-services` bridges all AI containers across compose files; `ix-databases_shared-databases` provides shared DB access 4. **NFS for Immich** — photo library lives on Serenity's large array; PD mounts on demand (not at boot) 5. **TrueNAS manages Docker** — never use `systemctl restart docker` on PD; use `docker compose` or `docker restart` for individual containers -6. **Credential hygiene** — Gitea remote uses HTTPS + credential store; GitHub remote uses SSH key (`/root/.ssh/id_gitea`) +6. **Credential hygiene** — Gitea pushes from PD/NOMAD use internal SSH (`ssh://git@10.5.1.6:2222//.git`); GitHub remote uses SSH key (`/root/.ssh/id_gitea`) diff --git a/docs/architecture/SERVICES_DIRECTORY.md b/docs/architecture/SERVICES_DIRECTORY.md index 08a3583..4282978 100644 --- a/docs/architecture/SERVICES_DIRECTORY.md +++ b/docs/architecture/SERVICES_DIRECTORY.md @@ -20,7 +20,7 @@ All homelab services, their hosts, ports, and current status. | Dockhand | 3230 | http://pd:3230 | ✅ Active | | Uptime Kuma | 3001 | http://pd:3001 | ✅ Active | | Gotify | 8443 | https://pd:8443 | ✅ Active | -| Gitea | 3002 / 2222 | http://pd:3002 (SSH: 2222) | ✅ Active | +| Gitea | 3002 / 2222 | http://pd:3002 / http://10.5.1.6:3002 (SSH: `ssh://git@10.5.1.6:2222//.git`) | ✅ Active | | Shlink | 8087 | http://pd:8087 | ✅ Active | | Shlink Web Client | 8088 | http://pd:8088 | ✅ Active | | RackPeek | 8283 | http://pd:8283 | ✅ Active | diff --git a/docs/operations/SECRETS_MANAGEMENT.md b/docs/operations/SECRETS_MANAGEMENT.md index 443306b..d62610c 100644 --- a/docs/operations/SECRETS_MANAGEMENT.md +++ b/docs/operations/SECRETS_MANAGEMENT.md @@ -172,7 +172,7 @@ On a fresh PD after reinstalling TrueNAS: ``` 4. **Clone the main stacks repo:** ```bash - git clone git@gitea.paccoco.com:fizzlepoof/truenas-stacks.git /mnt/docker-ssd/docker/compose + git clone ssh://git@10.5.1.6:2222/fizzlepoof/truenas-stacks.git /mnt/docker-ssd/docker/compose ``` 5. **Redeploy stacks** per `DEPLOYMENT_CHECKLIST.md` diff --git a/docs/operations/STACK_STANDARDS.md b/docs/operations/STACK_STANDARDS.md index 5a76ba1..9112e90 100644 --- a/docs/operations/STACK_STANDARDS.md +++ b/docs/operations/STACK_STANDARDS.md @@ -5,7 +5,10 @@ Remotes: - GitHub: `git@github.com:Paccoco/truenas-stacks.git` -- Gitea: `https://gitea.paccoco.com/fizzlepoof/truenas-stacks.git` +- Gitea web: `http://10.5.1.6:3002/fizzlepoof/truenas-stacks` +- Gitea SSH: `ssh://git@10.5.1.6:2222/fizzlepoof/truenas-stacks.git` + +Use the internal Gitea SSH remote from PD/NOMAD. Port `2222` is SSH, not HTTP. ## Stack Layout Each production stack lives in a subdirectory of the repo root. @@ -116,7 +119,7 @@ After changing a healthcheck, must `down` then `up` (not just restart). cd /mnt/docker-ssd/docker/compose git add . git commit -m "description" -git push # pushes to both GitHub and Gitea +git push ssh://git@10.5.1.6:2222/fizzlepoof/truenas-stacks.git main ``` All `.env` files are gitignored. Only compose files, `.env.example`, and init scripts are committed.