From 90a4625b5ad85fde83782e006fc1dc88b2157c30 Mon Sep 17 00:00:00 2001 From: nathan Date: Wed, 20 May 2026 19:14:21 -0700 Subject: [PATCH] Document Gitea container repair --- dev/HANDOFF.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/dev/HANDOFF.md b/dev/HANDOFF.md index 18f1b4ba..623454c6 100644 --- a/dev/HANDOFF.md +++ b/dev/HANDOFF.md @@ -1,5 +1,33 @@ # Agrarian Codex Handoff +## Gitea Container Repair - 2026-05-20 + +- Gitea is hosted on Unraid as Docker container `Gitea`. +- LAN endpoint: + - Web UI: `http://192.168.5.21:3000` + - Git SSH: `192.168.5.21:2221` +- Persistent data path: + `/mnt/user/appdata/gitea` +- What broke: + - the container was started with Unraid's Tailscale hook as its entrypoint. + - that hook waited for Tailscale authentication and never launched Gitea. + - Docker showed no host port bindings because the container correctly uses + `br0` with static IP `192.168.5.21`; the real issue was that Gitea was not + running. +- Repair performed: + - recreated only the container definition, preserving + `/mnt/user/appdata/gitea`. + - restored the official `gitea/gitea` entrypoint. + - kept `br0` static IP `192.168.5.21`. + - set `SSH_LISTEN_PORT=2221` plus matching Gitea server config. + - updated Unraid template + `/boot/config/plugins/dockerMan/templates-user/my-Gitea.xml` so Tailscale + stays disabled on future GUI recreates. +- Verification: + - `curl http://192.168.5.21:3000/` returns the Gitea installation page. + - TCP `192.168.5.21:2221` is open. + - TCP `192.168.5.21:22` is closed. + ## Agrarian 0.1.Q Craft Shelter Gate - 2026-05-19 - Completed the sixth `0.1.Q MVP QA Gates` item: