Configuration¶
Strix is configured via environment variables. The recommended way to install and configure Strix is via strix-setup, which generates secure defaults for all credentials and settings. After setup, only minimal tweaking should be required (SSO, domain, etc.).
A complete reference of all variables with comments is available in .env.example.
| Variable | Default | Description |
|---|---|---|
STRIX_PORT |
8080 |
HTTP server port |
STRIX_MAX_QUERY_ROWS |
10000 |
Maximum rows returned per query |
STRIX_SECURE_COOKIES |
false |
Set true to enable Secure flag on session cookies (requires HTTPS) |
POSTGRES_HOST |
localhost |
PostgreSQL host |
POSTGRES_PORT |
5432 |
PostgreSQL port |
POSTGRES_DB |
strix |
PostgreSQL database name |
POSTGRES_USER |
strix |
PostgreSQL username |
POSTGRES_PASSWORD |
strix |
PostgreSQL password |
CLICKHOUSE_HOST |
localhost |
ClickHouse host |
CLICKHOUSE_PORT |
9000 |
ClickHouse port |
CLICKHOUSE_DB |
logs |
ClickHouse database name |
CLICKHOUSE_USER |
default |
ClickHouse username |
CLICKHOUSE_PASSWORD |
(empty) | ClickHouse password |
STRIX_CORS_ORIGINS |
http://localhost:8080,http://127.0.0.1:8080 |
Comma-separated allowed CORS origins |
STRIX_DOMAIN |
localhost |
Domain for Caddy reverse proxy (used for automatic HTTPS) |
STRIX_PASSWORD_PEPPER |
(generated by strix-setup) | Secret added to password hashes. Set once at install time; changing it invalidates all passwords |
STRIX_FEED_ENCRYPTION_KEY |
(generated by strix-setup) | AES key for encrypting private Git repository credentials in alert feeds |