Skip to content

Configuration ​

The native binary reads exported environment variables. The deployment scripts parse .env as literal key/value pairs without executing shell code. Exported variables take precedence. Do not use shell substitutions inside .env.

Engine variables ​

VariableDefaultPurpose
TECHPEDIA_ADDR0.0.0.0:8080Native HTTP listener; Compose sets the internal listener
TECHPEDIA_DATA_DIRdataNative runtime root; Compose mounts ./data at /data
TECHPEDIA_PUBLIC_URLhttp://localhost:8080Exact public origin for canonical URLs and OAuth/origin checks
TECHPEDIA_CSP_MODEreport-onlySet enforce only after testing actual policy compatibility
TECHPEDIA_BOOTSTRAP_ADMIN_USERNAMEemptySingle immutable owner identity
TECHPEDIA_BOOTSTRAP_ADMIN_PASSWORDemptyInitial password only; does not reset an existing account
TECHPEDIA_MEDIA_STORAGE_LIMIT_BYTES943718400Global media storage budget
TECHPEDIA_MEDIA_UPLOAD_LIMIT_BYTES10485760Per-upload byte limit
TECHPEDIA_INTERFACE_AUTO_TRANSLATIONtrueExternal interface draft translation
TECHPEDIA_INTERFACE_TRANSLATION_URLMyMemory endpointTranslation service endpoint
TECHPEDIA_INTERFACE_TRANSLATION_EMAILemptyOptional provider contact address
TECHPEDIA_ANALYTICS_ENABLEDtrueBuilt-in aggregate traffic statistics
TECHPEDIA_ANALYTICS_COUNTRY_HEADERCF-IPCountryTrusted-proxy country hint
TECHPEDIA_MCP_ENABLEDfalseAdministrator-only OAuth/MCP integration
TECHPEDIA_SERVER_LOCATIONemptyOptional administrator-visible server location

The example file disables external translation for an explicit opt-in. Engine fallback defaults apply when a variable is omitted. Keep the bootstrap username unchanged after setup; use account management rather than changing the environment to reset a password.

Docker and HTTPS ​

TECHPEDIA_ENABLE_HTTPS=true enables the production Caddy profile in start.sh. Set TECHPEDIA_DOMAIN, TECHPEDIA_TLS_EMAIL, and TECHPEDIA_PUBLIC_URL=https://your-domain together. DNS must point at the server. TECHPEDIA_HTTP_BIND=127.0.0.1 keeps the backend host port private.

An external reverse proxy may terminate HTTPS instead. Keep the public origin HTTPS, disable the bundled Caddy profile, and restrict backend access to the proxy. Do not accept forwarded country/security headers directly from arbitrary clients. See deployment and security.

Original engine source: Blue Oak Model License 1.0.0. Third-party assets retain their own terms.