.env.example

# Last.fm provider - Optional, defaults to enabled
# Set to 'false' to disable Last.fm (e.g. if you only want to use ListenBrainz)
# LASTFM_ENABLED=true

# Last.fm API Key - Required when LASTFM_ENABLED is true (default)
# Get yours at https://www.last.fm/api/account/create
LASTFM_API_KEY=your_lastfm_api_key_here

# Adapter configuration (build-time) - Optional, defaults to Node.js
# Set to 'true' to use Vercel serverless adapter (required for Vercel deployment)
# USE_VERCEL_ADAPTER=false

# Cache provider - Optional, defaults to filesystem
# Options: 'filesystem' (for Node.js/VPS) or 'kv' (for Upstash Redis)
# CACHE_PROVIDER=filesystem

# Upstash Redis - Required when CACHE_PROVIDER=kv
# Auto-injected by Vercel when using the Upstash integration
# For local dev, get these from your Upstash dashboard
# UPSTASH_REDIS_REST_URL=https://xxx.upstash.io
# UPSTASH_REDIS_REST_TOKEN=xxx

# Cache TTL configuration (in hours) - Optional, defaults shown below
# CACHE_TTL_7DAY=6        # 6 hours for 7-day period
# CACHE_TTL_1MONTH=12     # 12 hours for 1-month period
# CACHE_TTL_3MONTH=24     # 24 hours (1 day) for 3-month period
# CACHE_TTL_6MONTH=48     # 48 hours (2 days) for 6-month period
# CACHE_TTL_12MONTH=72    # 72 hours (3 days) for 12-month period
# CACHE_TTL_OVERALL=168   # 168 hours (7 days) for overall period

# Cache size limits - Optional, defaults shown below
# CACHE_MAX_SIZE_MB=1024  # Maximum cache size in MB (1GB)
# CACHE_MAX_ENTRIES=10000 # Maximum number of cached images

# Matomo Analytics - Optional, disabled by default
# All three variables must be explicitly set to enable tracking
# Never active in dev mode, preview, or forks without these vars
# MATOMO_ENABLED=true
# MATOMO_HOST=your-matomo-instance.example.com
# MATOMO_SITE_ID=1
# MATOMO_TOKEN_AUTH=your-token-here  # Optional: forwards real visitor IP (Administration → Security → Auth tokens)