Skip to content

Configuration

AIDev edited this page Sep 17, 2026 · 1 revision

Configuration

Environment variables

Variable What it's for
POSTGRES_PASSWORD The database bundled inside the container. Never exposed outside it — pick anything.
AUTH_SECRET Signs session cookies. Generate with openssl rand -base64 32.
MASTER_ENCRYPTION_KEY Encrypts saved Plex/Jellyfin/Sonarr/Radarr credentials. openssl rand -base64 32. Back this up — losing it makes those credentials unreadable.
TMDB_API_KEY or TMDB_ACCESS_TOKEN TMDb, the source of all metadata. Can also be set in Settings → Integrations instead.
TVDB_API_KEY / TVDB_PIN Optional. Fills in posters and overviews for very new or niche shows.
APP_PORT The port on the host. Defaults to 3000.

Integrations (Settings → Integrations, admin only)

  • TMDb — one key for the whole instance. Test-and-save in the app, or set the environment variable.
  • TheTVDB — optional metadata fallback for TV.
  • Plex — connect with OAuth; libraries sync in the background.
  • Jellyfin — server URL plus an API key from Jellyfin's dashboard (Administration → API Keys). Works alongside Plex, instead of it, or not at all.
  • Sonarr / Radarr — server URL and API key, with a default quality profile and root folder used for new adds.
  • Trakt — paste a public list or watchlist URL and everything missing goes into the request queue. Needs only a free API client id, no sign-in.
  • Discord / ntfy / generic webhook — where notifications get sent, on top of the in-app bell.
  • Disconnect removes the credential and whatever it had synced, so nothing stale is left behind.

Sonarr/Radarr webhooks

Settings → Integrations generates a webhook URL with a per-account secret. Paste it into Sonarr's or Radarr's own Connect settings so Marquee hears about grabs and completed downloads. Those requests come from your LAN and carry the secret in the URL — they don't use your login.

Scheduled work

Library syncs run on a schedule inside the container, with a disk-space snapshot each night that feeds the storage forecast. Settings → Jobs shows the schedule and lets an admin run one immediately.

Clone this wiki locally