docs(deploy): add deploy/README.md and record the live instance

The deploy/ directory had no entry point: how to stand the stack up lived
only in comments inside docker-compose.yml, and the maintainer's own
instance (provenance.paul.farm) was written down nowhere in the repo —
it had to be rediscovered from an unrelated repo's research log.

Add deploy/README.md covering the run/build commands, the LAN-push /
FQDN-pull registry split, the env-driven site address, and the Watchtower
+ one-shot-migrate caveat, plus a "maintainer's instance" section with
the URL, host, ingress and deploy path. Cross-reference it from CLAUDE.md.

Also note the live instance reports "env":"development" — its .env never
set APP_ENV=production. Informational only (app_env gates no behavior),
but .env.example now says to set it on a real deployment.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_01BeRh7Vwq8j9s6jshaMUNCd
Signed-off-by: Justin Paul <[email protected]>

This commit is contained in:

justin

2026-09-20 22:43:33 -04:00

co-authored by

Claude Opus 5

parent 7043532c3b

commit 05aa57c880

3 changed files with 53 additions and 1 deletions

									
										deploy/.env.example
									
		+2
		
												View File
												
				@@ -2,6 +2,8 @@

				# Everything is twelve-factor; no endpoints or secrets live in code.

				# --- Core ---

				# development | production. Set to `production` on a real deployment — it is

				# reported by /health and the owner /admin surface.

				APP_ENV=development

				# Instance owner / operator. The account(s) whose email is named here get