backend: zero-setup Docker — auto-generate & persist secrets

`docker compose up` now works with no .env editing. A new entrypoint
(docker-entrypoint.sh) generates any missing secret (BETTER_AUTH_SECRET,
AI_CREDENTIALS_KEY) on first start and persists it to the temetro_secrets
volume, so values stay stable across restarts (rotating them would log users
out / invalidate stored AI keys). Real values passed via .env/compose still win.

This also fixes the boot failure where the compose backend ran with
NODE_ENV=production but never passed AI_CREDENTIALS_KEY through, tripping the
production guard. The secret is now an optional pass-through and BETTER_AUTH_SECRET
no longer hard-fails when unset.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Khalid Abdi
2026-06-13 19:15:11 +03:00
parent a3f4cf8633
commit a80086ef72
4 changed files with 67 additions and 8 deletions
+13 -3
View File
@@ -1,7 +1,10 @@
# Full-stack dev/run orchestration for temetro.
#
# cp .env.example .env # then set BETTER_AUTH_SECRET
# docker compose up # db + backend + frontend
# docker compose up # db + backend + frontend — that's it.
#
# No .env or secret setup is required: the backend generates any missing
# secrets on first start and persists them (see docker-entrypoint.sh). Create a
# .env only if you want to override something (SMTP, a real auth secret, etc.).
#
# Frontend -> http://localhost:3000
# Backend -> http://localhost:4000
@@ -41,7 +44,10 @@ services:
condition: service_healthy
environment:
DATABASE_URL: postgres://temetro:temetro@db:5432/temetro
BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET:?set BETTER_AUTH_SECRET in .env (openssl rand -base64 32)}
# Secrets are optional: if unset, the entrypoint generates and persists
# them (to the temetro_secrets volume). Pass real values here to override.
BETTER_AUTH_SECRET: ${BETTER_AUTH_SECRET:-}
AI_CREDENTIALS_KEY: ${AI_CREDENTIALS_KEY:-}
BETTER_AUTH_URL: http://localhost:4000
FRONTEND_URL: http://localhost:3000
PORT: "4000"
@@ -51,6 +57,9 @@ services:
SMTP_USER: ${SMTP_USER:-}
SMTP_PASS: ${SMTP_PASS:-}
SMTP_FROM: ${SMTP_FROM:-temetro <no-reply@temetro.local>}
volumes:
# Persists auto-generated secrets so they stay stable across restarts.
- temetro_secrets:/var/lib/temetro
ports:
- "4000:4000"
@@ -78,3 +87,4 @@ services:
volumes:
temetro_pgdata:
temetro_secrets: