● Set up
Configuration
every setting, where it lives.
Two places hold settings: build-time values in the app, and the server's .env file. This page lists all of them.
01Server environment variables
Copy server/.env.example to server/.env. Never publish this file.
| Name | Default | Purpose and where to get it |
|---|---|---|
ADMIN_SECRET_KEY | a generated file next to the database | Encrypts the store keys saved in the console. Make one with openssl rand -hex 32. Back it up: without it the saved keys cannot be read. |
ADMIN_SETUP_TOKEN | a one-time code printed in the log | The code that creates the first console owner. Make one with openssl rand -hex 24 or leave empty. Remove it after the owner exists. |
PORT | 8787 | HTTP port. |
DATABASE_PATH | data/chargeline.sqlite | The SQLite file. The console keeps its own file beside it. In Docker it is /app/data/chargeline.sqlite. |
TRUST_PROXY_HOPS | 0 | How many reverse proxies you control in front of the server. Use 1 behind Caddy or nginx. Wrong values make rate limits see the wrong address. |
ADMIN_DEMO_PASSWORD | unset | Only for a public read-only demo console. Leave empty on a real install. |
02App build-time values
| Value | Where | Meaning |
|---|---|---|
API_BASE_URL | --dart-define=API_BASE_URL=https://... on flutter run / flutter build | Your server's origin. Empty means no server: built-in defaults. |
| Brand, links, product ids | app/lib/brand.dart | See Rename. |
With a server, the app loads GET /v1/config (cached 5 minutes, with an ETag). If the server is unreachable it uses the last copy it saved, then the built-in defaults. Server values override brand.dart values.
03The three server calls
| Call | When |
|---|---|
GET /v1/config | Public, no login. Brand, paywall, features, alert limits, announcement, update rule, habit cards. |
POST /v1/ping | Only if the user turned on "Share anonymous usage counts" in Settings (off by default). At most once a day. |
POST /v1/purchases/verify | Only if you switch verification on in the console. Otherwise the server answers 501 verification_off and the app trusts the purchase result from the store on the device. |
All /v1 routes are limited to 60 requests a minute per address (answer 429). The full request and answer shapes are in contract/CONTRACT.md.