.env.example

# Your music library.
#
# Without Docker: absolute paths, comma-separated.
HARMONIE_LIBRARIES=/home/you/Music

# With compose: the container sets HARMONIE_LIBRARIES=/music itself and never
# sees the value above. Set the host directory to mount there instead.
# MUSIC_DIR=/home/you/Music

# Docker only: which host address publishes the port. Defaults to 127.0.0.1;
# use 0.0.0.0 to reach the API from another machine.
# BIND_ADDRESS=0.0.0.0

# Where to store the SQLite database. Defaults to the platform user-data
# directory (~/.local/share/harmonie on Linux,
# ~/Library/Application Support/harmonie on macOS).
# HARMONIE_DATA_DIR=/var/lib/harmonie

# Number of analysis worker processes. Defaults to CPU count.
# HARMONIE_WORKERS=4

# Periodic scan interval in hours. 0 disables scheduled scans.
HARMONIE_SCAN_INTERVAL_HOURS=24

# Run a scan immediately on startup. Useful when bootstrapping.
HARMONIE_SCAN_ON_STARTUP=true

# HTTP server. 0.0.0.0 binds to every interface; switch to 127.0.0.1 for
# loopback-only.
HARMONIE_HOST=0.0.0.0
HARMONIE_PORT=8842

# Optional API key. If set, clients must send X-API-Key header. Leave empty to
# disable auth (suitable for trusted local networks behind a reverse proxy).
# HARMONIE_API_KEY=

# Log level: DEBUG, INFO, WARNING, ERROR.
HARMONIE_LOG_LEVEL=INFO