fix: gitea boot persistence via quadlet (incident 2026-08-16)

unattended-upgrades rebooted dankclaw at 15:01; the legacy
podman-compose gitea stack had no systemd units, so rootless podman
did not auto-start the containers. Gitea was down ~1 hour.

- add quadlet units (dankclaw/gitea/quadlet/): gitea-postgres,
  gitea-server, gitea-caddy + gitea.network (DNS enabled; the default
  rootless podman network has dns_enabled=false)
- add gitea stack Caddyfile (upstream gitea-server:3000) and
  .env.example; live password stays in /opt/gitea/.env (0600)
- fix latent name bugs in main stack config: DATABASE_HOST
  gitea-postgres, Caddyfile upstream gitea-server
- docs: rewrite Gitea page for the quadlet stack (management, boot
  persistence, secrets, gotchas, incident log); fix port 3000 in
  stack table; Postgres connection notes
- legacy compose retired on target to /opt/gitea/.deprecated/

dankclaw/gitea/.env.example

@@ -0,0 +1,4 @@
+# Gitea stack secrets. Copy to /opt/gitea/.env on dankclaw (mode 0600).
+# The live password never enters this repo.
+
+GITEA_DB_PASSWORD=changeme

dankclaw/gitea/Caddyfile

@@ -0,0 +1,7 @@
+# Gitea stack Caddyfile (dedicated Caddy container, quadlet-managed).
+# Lives on the host at /opt/gitea/data/caddy/Caddyfile.
+# Upstream is the quadlet container name gitea-server (port 3000 inside).
+
+gitea.franksdank.cloud {
+    reverse_proxy gitea-server:3000
+}

dankclaw/gitea/quadlet/gitea-caddy.container

@@ -0,0 +1,31 @@
+# Quadlet unit: Gitea Caddy reverse proxy (rootless, boot-persistent).
+#
+# Install path on dankclaw: ~/.config/containers/systemd/gitea-caddy.container
+# Unit name: gitea-caddy.service (podman 5.x drops the container- prefix)
+#
+# Serves gitea.franksdank.cloud (public domain, DNS pending). The LAN
+# reaches Gitea directly on port 3000. This file holds no secrets.
+# See docs/Dankclaw/Gitea.md.
+
+[Unit]
+Description=Gitea Caddy reverse proxy container
+Wants=gitea-server.service
+After=gitea-server.service network.target
+
+[Container]
+ContainerName=gitea-caddy
+Network=gitea.network
+Image=docker.io/library/caddy:latest
+PublishPort=80:80
+PublishPort=443:443
+Volume=/opt/gitea/data/caddy/Caddyfile:/etc/caddy/Caddyfile
+Volume=/opt/gitea/data/caddy/site:/srv
+Volume=/opt/gitea/data/caddy/config:/config
+Volume=/opt/gitea/data/caddy/data:/root/.local/share/caddy
+
+[Service]
+TimeoutStartSec=900
+Restart=always
+
+[Install]
+WantedBy=default.target

dankclaw/gitea/quadlet/gitea-postgres.container

@@ -0,0 +1,31 @@
+# Quadlet unit: Gitea PostgreSQL (rootless, boot-persistent).
+#
+# Install path on dankclaw: ~/.config/containers/systemd/gitea-postgres.container
+# Unit name: gitea-postgres.service (podman 5.x drops the container- prefix)
+#
+# The DB password lives in /opt/gitea/.env on the host (mode 0600).
+# This file holds no secrets. See docs/Dankclaw/Gitea.md.
+# The [Service] EnvironmentFile= line lets systemd expand
+# ${GITEA_DB_PASSWORD} in the generated ExecStart.
+
+[Unit]
+Description=Gitea PostgreSQL container
+After=network.target
+
+[Container]
+ContainerName=gitea-postgres
+Network=gitea.network
+Image=docker.io/library/postgres:16-alpine
+EnvironmentFile=/opt/gitea/.env
+Environment=POSTGRES_USER=gitea
+Environment=POSTGRES_PASSWORD=${GITEA_DB_PASSWORD}
+Environment=POSTGRES_DB=gitea
+Volume=/opt/gitea/data/gitea-postgres:/var/lib/postgresql/data
+
+[Service]
+EnvironmentFile=/opt/gitea/.env
+TimeoutStartSec=900
+Restart=always
+
+[Install]
+WantedBy=default.target

dankclaw/gitea/quadlet/gitea-server.container

@@ -0,0 +1,44 @@
+# Quadlet unit: Gitea web server (rootless, boot-persistent).
+#
+# Install path on dankclaw: ~/.config/containers/systemd/gitea-server.container
+# Unit name: gitea-server.service (podman 5.x drops the container- prefix)
+#
+# The [Service] EnvironmentFile= line lets systemd expand
+# ${GITEA_DB_PASSWORD} in the generated ExecStart.
+# The DB password lives in /opt/gitea/.env on the host (mode 0600).
+# This file holds no secrets. See docs/Dankclaw/Gitea.md.
+#
+# Ports (live): 3000 = HTTP UI/API, 2222 = git SSH. The docs table in
+# Dankclaw Stack.md historically said 3001; the live host port is 3000.
+
+[Unit]
+Description=Gitea web server container
+Wants=gitea-postgres.service
+After=gitea-postgres.service network.target
+
+[Container]
+ContainerName=gitea-server
+Network=gitea.network
+Image=docker.io/gitea/gitea:latest
+EnvironmentFile=/opt/gitea/.env
+Environment=DATABASE_TYPE=postgres
+Environment=DATABASE_HOST=gitea-postgres
+Environment=DATABASE_NAME=gitea
+Environment=DATABASE_USER=gitea
+Environment=DATABASE_PASSWD=${GITEA_DB_PASSWORD}
+Environment=DATABASE_PORT=5432
+Environment=USER_UID=1000
+Environment=USER_GID=1000
+PublishPort=0.0.0.0:3000:3000
+PublishPort=2222:22
+Volume=/opt/gitea/data/gitea-gitea:/data
+Volume=/etc/timezone:/etc/timezone:ro
+Volume=/etc/localtime:/etc/localtime:ro
+
+[Service]
+EnvironmentFile=/opt/gitea/.env
+TimeoutStartSec=900
+Restart=always
+
+[Install]
+WantedBy=default.target

dankclaw/gitea/quadlet/gitea.network

@@ -0,0 +1,10 @@
+# Quadlet network: private bridge for the Gitea stack (rootless).
+#
+# Install path on dankclaw: ~/.config/containers/systemd/gitea.network
+# Unit name: gitea-network.service (podman network name: systemd-gitea)
+#
+# DNS is enabled by default for quadlet networks. This matters: the
+# automatic "podman" default network has dns_enabled=false, so container
+# names (gitea-postgres, gitea-server, gitea-caddy) would not resolve.
+
+[Network]