Files

T

grokbot_ty 369d404c29 docs: env-agnostic deploy (APP_HOSTNAME, inventory, Caddy order)

DEPLOYMENT is host-variable: APP_HOST/APP_HOSTNAME/ports, inventory
worksheet, corrected Caddy handle /api/* before frontend. Drop RemBG
and output_px 1000 as deploy SoT. AGENTS §9, README, IMPL host wording
match. Historical .201 lab is a non-normative callout only.

2026-09-01 05:26:45 +00:00

1.7 KiB

Raw Blame History

Deploy inventory worksheet

Fill this at Gate B on the designated host before any port bind or Caddy merge. Do not assume a prior lab IP or hostname. See docs/DEPLOYMENT.md.

Host

Field	Value
Inventory date
Operator
Machine name / role
`APP_HOST` (LAN or Tailscale IP/name used in DNS)
`APP_HOSTNAME` (HTTPS site name, e.g. `slab.example.local`)
OS / Docker version
Notes

Ports and collisions

Check	Result
`docker ps` summary (names + published ports)
Free HTTP port for frontend bind (`FRONTEND_PORT`, default 18080)
Free port for fastapi bind (`FASTAPI_PORT`, default 18081)
Caddy public HTTPS port in use by other sites
Co-resident apps that own ports (example: bolt.diy on 8443-class)

Caddy

Field	Value
Caddy config path (host file or container)
Existing site blocks that share this host
TLS mode (`internal` CA vs other)
Phone CA trust verified? (yes/no + how)

DNS / reachability

Field	Value
DNS source (Pi-hole / AdGuard / MagicDNS / hosts)
A record: `APP_HOSTNAME` → `APP_HOST`
Reachable from phone on LAN?
Reachable from phone on Tailscale?

Volumes and backup

Field	Value
Docker volume dir convention
Backup target path (local)
Off-box mirror (if any)

Smoke after first up

Check	Pass?
`curl -k https://${APP_HOSTNAME}/api/health`
Compose `frontend` + `fastapi` healthy
Caddy `/api/*` reaches fastapi (not frontend)

Sign-off

Role	Name	Date
Inventory complete
Ty Gate B (optional)

1.7 KiB Raw Blame History

Deploy inventory worksheet

Host

Ports and collisions

Caddy

DNS / reachability

Volumes and backup

Smoke after first up

Sign-off

1.7 KiB

Raw Blame History