Skip to content

ADR-0006: CT 101 serves generated documentation behind ingress Caddy

  • Status: Accepted
  • Date: 2026-07-02
  • Supersedes: Nginx and direct CT 103 static roots

Context and decision

The Forgejo runner writes artifacts on CT 101. A rootless docs-static Caddy container mounts that directory read-only and serves port 30084. Ingress Caddy on CT 103 terminates TLS and proxies the backend.

Alternatives

Mounting the CT 101 volume in CT 103, copying every build to CT 103, or serving directly from the job container were rejected.

Consequences

There is one mutable artifact location. Ingress remains stateless with respect to site files. A failed build can leave a healthy but stale site.

Validation evidence

Quadlet, mount, ownership, backend HTTP, ingress route, and HTTPS returned the expected state on 2026-07-17.