System

The System page is your operational dashboard: application status, health checks, background task progress, and a searchable log viewer — all in one place.

Status

The status panel shows runtime information about the running Luminarr instance. This is useful for support requests and verifying your deployment.

Field Description
Version The Luminarr release version, e.g. v0.12.1
Go version The Go runtime version the binary was compiled with, e.g. go1.23.4
Build time UTC timestamp when the binary was built
Database SQLite version and path to the active database file
Uptime How long the process has been running since last start
AI status Configured if a Claude API key is set, Not configured otherwise
TMDB status Configured if a TMDB API key is set and reachable

Health Checks

Luminarr runs periodic health checks and displays the current status of each. A failing check is also surfaced as a health event in the Activity log.

library_paths

Verifies that all configured root folder paths exist on disk and are writable by the Luminarr process.

download_clients

Pings each configured download client. Fails if the client is unreachable or returns an auth error.

indexers

Tests each enabled indexer with a probe query. Fails if the indexer returns an error or is rate-limited.

Each check shows one of three states: Healthy Failing Unchecked

Health checks run every 30 minutes. Click Run checks now to trigger an immediate evaluation without waiting for the next scheduled run.

Scheduled Tasks

Luminarr runs several background jobs on fixed intervals. The Tasks panel shows each job's last run time, next scheduled run, and current status.

Task Interval What it does
RSS sync 15 min Queries all enabled indexers for releases matching monitored movies
Queue poll 30 sec Polls download clients for completion; triggers import on finished downloads
Library scan 6 hours Walks library paths to detect new, missing, or mismatched files
Metadata refresh 24 hours Refreshes TMDB metadata for movies not updated recently
Storage snapshot 24 hours Records library size and movie count for the Stats growth chart
Health check 30 min Tests library paths, download clients, and indexers; logs issues

Click Run now next to any task to trigger it immediately. A spinner appears while the task is running; results appear in the Activity log.

Logs

The log viewer shows structured application logs in reverse chronological order. Each log line includes a timestamp, level, and message, with additional fields expandable inline.

Level filtering

Use the level filter to limit output to the severity you care about. Levels from lowest to highest: DEBUG INFO WARN ERROR

Expandable fields

Log entries with structured metadata (movie ID, quality, file path, etc.) show an expand chevron. Click it to reveal all key-value pairs associated with that log entry — useful for tracing import failures or grab decisions.

Logs are stored in the database and rotated after 10,000 entries. For persistent log files, configure the LOG_FILE environment variable to write structured JSON to disk.