clarify mandatory admin bootstrap
CI / compose (push) Failing after 10m9s

This commit is contained in:
Marco0300
2026-09-03 16:24:53 +02:00
parent d33940e37f
commit 0478228c08
3 changed files with 15 additions and 2 deletions
+13
View File
@@ -1,5 +1,18 @@
# Portable deployment and recovery runbook (Phase 15)
## Initial administrator is mandatory
Before the **first** API startup, you must choose one administrator-provisioning method. The simplest method is to set both values in the untracked `.env` file:
```dotenv
BOOTSTRAP_ADMIN_EMAIL=admin@example.com
BOOTSTRAP_ADMIN_PASSWORD=<strong-temporary-password>
```
These are not application defaults; they are one-time provisioning inputs. If both values are blank, the API starts without creating an administrator and login cannot succeed. Existing users are never overwritten by changing these values later.
After the first successful login, remove both values from `.env`, restart the API, and rotate the administrator password through the supported account-management process. Never commit or share the password.
## Configuration
Copy `.env.example` to an untracked deployment environment file. Production requires a secret-manager supplied `SESSION_SECRET` of at least 32 characters and refuses `AUTOMATED_OUTREACH_ENABLED=true`. Keep bootstrap credentials one-time only; remove and rotate them after provisioning. Never place secrets in images, Compose YAML, logs, backups, or public web roots.