Skip to main content

Configuration

Little Origin is configured entirely through environment variables.

Environment Variables

VariableRequiredDescriptionDefault
JWT_SECRETYesSecret for signing auth tokens — use openssl rand -base64 32(none)
PORTNoAPI port3000
DATABASE_URLNoSQLite database pathfile:/.data/little-origin.db
SERVE_STATICNoServe the frontend from the API containertrue
NODE_ENVNoproduction or developmentproduction
TZNoContainer timezoneUTC
warning

Never commit secrets to version control. A leaked JWT_SECRET lets anyone forge sessions.

Database

Everything is stored in a single SQLite file (users, preferences, names, reviews, matches). Migrations run automatically on startup.

Back it up by copying the file — see Backups.

Authentication

  • Passwords hashed with Argon2
  • Access tokens expire after 15 minutes; refresh tokens after 7 days (rotated on use)

Logs

docker compose logs -f little-origin

Next Steps

  • Deploy - The full Docker Compose guide
  • Updating - Upgrades and rollbacks