App Settings

Application-level configuration: appearance, API credentials, UI preferences, and backup tools. These settings apply instance-wide rather than per-library or per-movie.

Appearance

Appearance

Control the visual presentation of the Luminarr UI. Settings are stored in the browser's localStorage and apply only to the current browser session.

Color Mode

Choose between Dark, Light, or System mode. System mode follows your operating system's preference and switches automatically.

Theme Presets

Luminarr ships with several accent color presets that change the primary highlight color used across the UI — buttons, links, badges, and gradient headings.

Violet

The default preset. A calm purple-blue accent.

Blue

A classic bright blue accent for a clean, minimal look.

Emerald

A green accent for those who prefer a warmer tone.

Preferences

UI Preferences

Tooltips

When enabled, hovering over buttons, quality badges, and status indicators shows a descriptive tooltip. Disable this if you prefer a cleaner interface once you are familiar with the UI.

Keyboard shortcut: Press ? anywhere in the app to open the keyboard shortcut reference, regardless of the tooltips setting.

Integrations

Configuration

TMDB API Key

Luminarr uses The Movie Database (TMDb) for all movie metadata, posters, and the Discover page. A free TMDb API key is required.

  1. 1

    Create a free account at themoviedb.org.

  2. 2

    Go to Settings → API and create a new API key (type: Developer).

  3. 3

    Copy the API Read Access Token (the long bearer token, not the short v3 key) and paste it into Luminarr.

Free tier is sufficient. Luminarr only uses the TMDb read API. The free tier has generous rate limits and is not expected to be exceeded in normal use.

Claude API Key

An optional Anthropic API key enables the AI command palette — a natural language interface for searching, adding, and managing movies. Without this key, the command palette functions as a standard search bar.

API usage costs money. The Claude API is billed per token. Each command palette query makes one API call. Monitor your usage at console.anthropic.com.

External Access

API Key

Luminarr exposes a REST API for external integrations. The API key shown here is the bearer token required to authenticate all non-browser API requests.

Example API request 
curl https://luminarr.yourdomain.com/api/movies \
  -H "Authorization: Bearer YOUR_API_KEY"
  • The key is auto-generated on first startup and stored in the database.
  • Click Regenerate to invalidate the old key and issue a new one. All existing integrations using the old key will stop working immediately.
  • The API is documented at /api/docs (OpenAPI / Swagger UI) when Luminarr is running.

Browser sessions use cookie auth, not the API key. The API key is only needed for programmatic or external access.

Data Safety

Backup & Restore

Luminarr's entire state — movies, quality profiles, indexers, download clients, settings — lives in a single SQLite database file. Back up that file to protect your configuration.

Creating a backup

Click Download Backup in Settings → Backup & Restore to download a snapshot of the database. The file is a standard SQLite database and can be opened with any SQLite browser.

Restoring

  1. 1

    Stop the Luminarr process.

  2. 2

    Replace the database file at /config/luminarr.db (Docker) or ~/.config/luminarr/luminarr.db (local) with your backup.

  3. 3

    Start Luminarr. Migrations run automatically; no manual steps required.

Movie files are not included in the backup. The backup contains only the database (metadata, settings, history). Your video files on disk are separate.