Fluksio/app
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: make init in the setup steps
Docs / docs (push) Successful in 22s
Details
pre-commit / pre-commit (push) Failing after 2m35s
Details
Test Backend / test-backend (push) Failing after 3m2s
Details

Browse Source 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
stroblme
2026-10-12 21:41:39 +02:00
co-authored by Claude Opus 5.5
parent c73c110406
commit 9e7f07e883
2 changed files with 9 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files
development.md
+4 -1
View File
@@ -15,7 +15,10 @@ root `.env` — change it there and re-run `make init`. `app/Makefile` takes tha
default only (`export DOMAIN ?= …`), so `make dev DOMAIN=…` overrides it and the override
reaches the recipes.
**App only.** `cd app && make dev` starts this stack on its own Traefik with all host ports
**App only.** In a bare clone of this repo, `make init` once (`.env` from `.env.example`
with generated secrets, the `proxy` docker network, prints the admin login), then
`make dev-local` serves the stack detached at `http://app.localhost` behind Traefik on
port 80. `make dev` starts this stack on its own Traefik with all host ports
published, in the foreground. `make dev-utils` starts just proxy and mailcatcher — the
useful half when the backend runs on the host.
docs/getting-started/facility-automation.md
+5 -2
View File
@@ -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,