Docs: make init in the setup steps

2026-10-12 21:41:39 +02:00
parent a86eb3051e
commit dd91954a21
2 changed files with 9 additions and 3 deletions
@@ -40,17 +40,20 @@ Clone the app repository and write its one configuration file:
 ```sh
 git clone https://git.stroblme.de/Fluksio/app.git ~/fluksio
 cd ~/fluksio
-cp .env.example .env
+make init                   # writes .env, generates its secrets, prints the admin login
 $EDITOR .env                # FIRST_SUPERUSER, ENVIRONMENT=production
 ```

+`make init` is safe to run again: it only fills secrets still set to
+`changethis`, and `.env` otherwise stays as you left it.
+
 `.env` is the whole configuration. The four settings that matter on day one:

 | Setting | What it does |
 |---|---|
 | `DOMAIN` | the hostname everything is served under, if you use one. Left alone it only names the issuer that agents authenticate against |
 | `FIRST_SUPERUSER` | the account you sign in with |
-| `FIRST_SUPERUSER_PASSWORD` | leave it as `changethis` and one is generated for you |
+| `FIRST_SUPERUSER_PASSWORD` | generated by `make init`; it prints it, and it stays in `.env` |
 | `ENVIRONMENT` | `production` closes the interactive API schema; `local` leaves it open |

 Everything the instance owns (the database, your flows, secrets, artifacts,