Skip to content

Configuration

Configuration is set during installation and written into the database. Runtime environment variables are also supported.

VariableDefaultDescription
XOLO_TRUST_PROXY0Set 1 when running behind a reverse proxy — reads real IP from X-Forwarded-For

The port is set at install time via the --port flag or the interactive prompt. To change it later, re-run install.sh or edit start.sh.

The installer generates a self-signed certificate at server/certs/cert.pem and server/certs/key.pem. Replace these files with a valid certificate (e.g. from Let’s Encrypt) for production use.

XoloC2 uses SQLite. The database file is server/xoloc2.db. Back it up before upgrades.

When deploying behind nginx, Apache, or Caddy, set XOLO_TRUST_PROXY=1 so the server reads the real client IP. See Redirectors for full config examples.