Skip to content

Environment variables

The documentation build checks that every TSMC_* variable the server and the CLI read is described here.

Variable Default Purpose
PORT 3000 port
HOST 127.0.0.1 address; 0.0.0.0 opens it to the network
TSMC_DB data/tsmc.db SQLite file
TSMC_FILES files next to the database attachments folder
TSMC_MAX_UPLOAD_MB 25 largest attachment, MB
TSMC_SECRET_KEY secret.key next to the database encryption key for tracker tokens: 64 hex characters or base64 of 32 bytes
TSMC_PUBLIC_URL RENDER_EXTERNAL_URL on Render, else the address from the request server address for links in filed bugs, e.g. https://tms.company.com
TSMC_SECURE_COOKIES — 1 if the interface is opened over HTTPS (cookies with the Secure flag)
TSMC_TRUST_PROXY — 1 behind a reverse proxy (client address from X-Forwarded-For)
TSMC_METRICS, TSMC_METRICS_TOKEN — 1 — Prometheus metrics on /metrics; with a token, only with Authorization: Bearer
TSMC_ADMIN_EMAIL, TSMC_ADMIN_PASSWORD, TSMC_ADMIN_NAME — create an administrator at start on an empty database (for automated installs)
Variable Default Purpose
TSMC_DEMO — 1 — demo mode: an empty database gets demo data, the demo accounts and their password are shown on the sign-in page. Not for servers others reach
TSMC_DEMO_DATA — 1 — the same demo data on a server others reach: the demo accounts are locked, an administrator from TSMC_ADMIN_* is required
TSMC_STAND_COMMIT, TSMC_STAND_BUILT_AT — the commit and build time of a team stand: a “Stand · commit” badge in the header
Variable Default Purpose
TSMC_URL http://127.0.0.1:3000 server address
TSMC_TOKEN — project API token (Project → Settings → API tokens); every command needs it
TSMC_LANG from LANG or the system language language of server messages: ru or en