Server deployment
hosting the optional backend.
One Node process and one SQLite file. Small and cheap to host.
01Docker
Flutter runs natively on Windows: use PowerShell for the flutter commands and Android builds (iOS builds need a Mac). For the server, either install Node.js 22.12+ for Windows and use PowerShell (replace cp .env.example .env with Copy-Item .env.example .env; there is no openssl by default, so use WSL or any random 64-character hex string), or run the commands in WSL 2 (Ubuntu) or Docker. macOS and Linux users can ignore this note.
cd server
cp .env.example .env # set ADMIN_SECRET_KEY
docker build -t chargeline-server .
docker run -p 8787:8787 -v chargeline-data:/app/data --env-file .env chargeline-server
The volume holds the databases. The image has a health check on /healthz. The Dockerfile was not run by the author (no Docker on the build machine): unverified, so test it once.
02Any Node host (VPS, PM2, systemd)
- On the server:
npm ci && npm run build. - Run
node dist/src/index.jswith the variables from Configuration, under PM2 or a systemd unit so it restarts. - Put it behind HTTPS (Caddy or nginx) and set
TRUST_PROXY_HOPS=1. - Build the app with
--dart-define=API_BASE_URL=https://your-domain.
SQLite is one file on one disk. Do not run several copies of the server against the same data, and avoid hosts with no persistent disk.
03Backups
Back up the data/ folder (the SQLite files) and your ADMIN_SECRET_KEY. Without the key the saved store credentials cannot be decrypted; you can enter them again.
04Stores
The app itself is published through App Store Connect and Google Play, see Release. There is no web version.