Environment Variables

All configuration options for the Rustrak server.

Required

DATABASE_URL

Rustrak supports two database backends selected at compile time.

SQLite:

# Relative file path
DATABASE_URL=sqlite://./rustrak.db
 
# Absolute path
DATABASE_URL=sqlite:///var/lib/rustrak/rustrak.db
 
# In-memory (for testing only — data lost on restart)
DATABASE_URL=sqlite::memory:

PostgreSQL:

# Format
postgres://username:password@host:port/database
 
# Examples
DATABASE_URL=postgres://rustrak:rustrak@localhost:5432/rustrak
DATABASE_URL=postgres://rustrak:rustrak@postgres:5432/rustrak  # Docker
DATABASE_URL=postgres://user:pass@host:5432/rustrak?sslmode=require  # With SSL

Security

SSL_PROXY

Set to true when running behind a reverse proxy that terminates SSL (nginx, Cloudflare, etc.). This enables secure cookies.

SSL_PROXY=true

When SSL_PROXY=true:

• Cookies are sent only over HTTPS (Secure flag enabled)
• SESSION_SECRET_KEY becomes required

SESSION_SECRET_KEY

Generate with:

openssl rand -hex 32

• Development: Optional (a random key is used, sessions don’t persist across restarts)
• Production with SSL_PROXY=true: Required

Server

HOST

The network interface the server listens on. The default (0.0.0.0) means “all interfaces” and is correct for Docker — you don’t need to set it explicitly.

Only change this if you want to restrict access to a specific interface:

HOST=127.0.0.1  # loopback only — useful for local dev behind a local proxy

Docker note: HOST=0.0.0.0 is already the default. You don’t need to include it in your docker-compose.yml or .env. If you set HOST=127.0.0.1 inside a container, the port mapping won’t work and the server will be unreachable.

PUBLIC_URL

The URL that Rustrak embeds in DSN strings. Must include the scheme (http:// or https://). Trailing slashes are stripped automatically.

# Production (behind reverse proxy)
PUBLIC_URL=https://api.yourcompany.com
 
# Self-hosted with custom port
PUBLIC_URL=http://192.168.1.10:9090

Why this matters: HOST=0.0.0.0 is the TCP bind address — it means “listen on all interfaces.” It is not a routable address. Without PUBLIC_URL, the DSN shown in the dashboard will contain http://0.0.0.0:8080/..., which your SDK cannot reach.

When unset, Rustrak falls back to http://{HOST}:{PORT} — fine for local development where HOST is localhost or 127.0.0.1.

Database Pool

Rate Limiting

Storage

SOURCEMAP_STORAGE_PATH

Where Rustrak stores source map chunks uploaded by Sentry SDKs. Chunks are stored in a content-addressable layout: a SHA-1 hash like abc123... is written to {SOURCEMAP_STORAGE_PATH}/ab/c123....map.

SOURCEMAP_STORAGE_PATH=/var/lib/rustrak/sourcemaps

Storage sizing: Each source map chunk is typically around 2MB. Multiply by the number of distinct source files across all your deployments. A typical JavaScript app with 50 source files uses around 100MB.

Production / multi-server deployments: All server instances must read and write from the same SOURCEMAP_STORAGE_PATH. Mount a shared volume (NFS, EFS, a network filesystem) and point every instance at it. Without this, chunks uploaded to one instance won’t be visible to others during bundle assembly.

Email Alerts (SMTP)

Global SMTP settings for email notifications. Channels can override these.

Dashboard URL

Bootstrap

CREATE_SUPERUSER="admin@example.com:secure-password"

Only creates user if database is empty.

Dashboard (Next.js)

Complete Example

SQLite (development / personal)

# .env file (SQLite — image tag: latest)
 
# Required
DATABASE_URL=sqlite:///data/rustrak.db
 
# Server
PORT=8080
RUST_LOG=info
 
# Dashboard
RUSTRAK_API_URL=http://localhost:8080

PostgreSQL (production)

# .env file (PostgreSQL — image tag: postgres)
 
# Required
DATABASE_URL=postgres://rustrak:password@postgres:5432/rustrak
 
# Security (required for production behind HTTPS proxy)
SSL_PROXY=true
SESSION_SECRET_KEY=a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890a1b2c3d4e5f67890
 
# Server
PORT=8080
RUST_LOG=info
PUBLIC_URL=https://api.yourcompany.com
 
# Database Pool
DATABASE_MAX_CONNECTIONS=20
 
# Rate Limiting
MAX_EVENTS_PER_MINUTE=1000
MAX_EVENTS_PER_HOUR=10000
 
# Dashboard
RUSTRAK_API_URL=https://rustrak.yourcompany.com
DASHBOARD_URL=https://rustrak.yourcompany.com
 
# Email Alerts (optional - can also configure per-channel)
SMTP_HOST=smtp.yourcompany.com
SMTP_PORT=587
SMTP_USERNAME=alerts@yourcompany.com
SMTP_PASSWORD=your-smtp-password
SMTP_FROM=alerts@yourcompany.com