Configuration

MiniAPM is configured entirely through environment variables. No configuration files needed.

Core Settings

Variable	Default	Description
SQLITE_PATH	./data/miniapm.db	Path to the SQLite database file
RUST_LOG	miniapm=info	Log level (debug, info, warn, error)
MINI_APM_URL	http://localhost:3000	Public URL of the MiniAPM server

Data Retention

Control how long data is kept before automatic cleanup:

Variable	Default	Description
RETENTION_DAYS_REQUESTS	7	Days to keep request data
RETENTION_DAYS_ERRORS	30	Days to keep error data
RETENTION_DAYS_SPANS	7	Days to keep trace spans
RETENTION_DAYS_HOURLY_ROLLUPS	90	Days to keep hourly aggregates

Example Docker Compose configuration:

environment:
  - RETENTION_DAYS_REQUESTS=14
  - RETENTION_DAYS_ERRORS=60
  - RETENTION_DAYS_SPANS=14

Performance Thresholds

Variable	Default	Description
SLOW_REQUEST_THRESHOLD_MS	500	Requests slower than this (in ms) are flagged as slow

Multi-Project Mode

By default, MiniAPM runs in single-project mode with one API key. Enable multi-project mode to manage multiple applications:

Variable	Default	Description
ENABLE_PROJECTS	false	Enable multi-project mode

When enabled:

• Each project gets its own API key
• Data is isolated between projects
• Dashboard can filter by project

Multi-User Mode

Enable user accounts for team access:

Variable	Default	Description
ENABLE_USER_ACCOUNTS	false	Enable user authentication
SESSION_SECRET	(auto-generated)	Secret for session cookies

When enabled:

• Default admin credentials: admin / admin (change immediately!)
• Uses Argon2 for password hashing
• Cookie-based session management

# Enable with a secure session secret
ENABLE_USER_ACCOUNTS=true
SESSION_SECRET=your-secure-random-string-here

Example Configurations

Development

SQLITE_PATH=./miniapm-dev.db
RUST_LOG=miniapm=debug
SLOW_REQUEST_THRESHOLD_MS=200

Production (Single App)

SQLITE_PATH=/data/miniapm.db
RUST_LOG=miniapm=info
RETENTION_DAYS_REQUESTS=14
RETENTION_DAYS_ERRORS=60
RETENTION_DAYS_SPANS=7

Production (Multi-Tenant)

SQLITE_PATH=/data/miniapm.db
RUST_LOG=miniapm=info
ENABLE_PROJECTS=true
ENABLE_USER_ACCOUNTS=true
SESSION_SECRET=generate-a-secure-random-string

Docker Environment

Pass environment variables to Docker:

docker run -d \
  -p 3000:3000 \
  -v miniapm_data:/data \
  -e RETENTION_DAYS_REQUESTS=14 \
  -e RETENTION_DAYS_ERRORS=60 \
  -e SLOW_REQUEST_THRESHOLD_MS=300 \
  ghcr.io/miniapm/miniapm

Or use an environment file:

# miniapm.env
RETENTION_DAYS_REQUESTS=14
RETENTION_DAYS_ERRORS=60
SLOW_REQUEST_THRESHOLD_MS=300

# Run with env file
docker run -d \
  -p 3000:3000 \
  -v miniapm_data:/data \
  --env-file miniapm.env \
  ghcr.io/miniapm/miniapm