-
Notifications
You must be signed in to change notification settings - Fork 1
Configuration
Adam Glover edited this page Aug 18, 2026
·
1 revision
VaultRequestrr is configured with environment variables. Many settings can also be managed (and changed live, without a restart) on the Admin Dashboard Settings page — where both exist, the env var acts as the first-run default and the dashboard value, persisted to the database, wins afterwards.
| Variable | Required | Default | Description |
|---|---|---|---|
DISCORD_TOKEN |
yes | — | Discord bot token |
DISCORD_GUILD_ID |
no | — | Register commands to one guild (instant). Blank = global (~1h) |
SEERR_URL |
yes | http://localhost:5055 |
Base URL of your Seerr instance |
SEERR_API_KEY |
yes | — | Seerr admin API key |
DATABASE_PATH |
no | data/vaultrequestrr.sqlite3 |
SQLite path for links and local state |
LOG_LEVEL |
no | INFO |
DEBUG/INFO/WARNING/ERROR
|
| Variable | Required | Default | Description |
|---|---|---|---|
REQUIRE_LINKING |
no | true |
Require Plex linking before the first request (Account Linking) |
DEFAULT_SEERR_USER_ID |
no | — | Fallback user id when linking is disabled |
| Variable | Required | Default | Description |
|---|---|---|---|
POLL_INTERVAL_SECONDS |
no | 600 |
Backstop poll interval; poller adapts to ~2 min with no webhook (0 disables) |
NOTIFY_ON_AVAILABLE |
no | true |
DM requester when media becomes available |
NOTIFY_ON_DECLINED |
no | true |
DM requester when a request is declined |
NOTIFY_ON_ISSUE_RESOLVED |
no | true |
DM reporter when their issue is resolved |
TRACK_EXTERNAL_REQUESTS |
no | true |
Also DM for requests made in the Seerr web UI (linked users only) |
WEBHOOK_SECRET |
no | — | Shared secret for the inbound Seerr webhook (blank = endpoint disabled) |
See Notifications for how the webhook and poller interact.
| Variable | Required | Default | Description |
|---|---|---|---|
ADMIN_DISCORD_IDS |
no | — | Comma-separated Discord ids that can approve requests and get notified |
APPROVALS_CHANNEL_ID |
no | — | Optional channel id to also post pending requests to |
| Variable | Required | Default | Description |
|---|---|---|---|
WEB_PASSWORD |
no | — | Set to enable the admin dashboard |
WEB_PORT |
no | 5056 |
Port the dashboard listens on |
| Variable | Required | Default | Description |
|---|---|---|---|
ANIME_SONARR_SERVER_ID |
no | — | Seerr Sonarr instance id for /anime series (blank = disabled) |
ANIME_RADARR_SERVER_ID |
no | — | Seerr Radarr instance id for /anime films (blank = disabled) |
ANIME_SONARR_PROFILE_ID / ANIME_SONARR_ROOT_FOLDER
|
no | — | Optional anime Sonarr profile id / root folder override |
ANIME_RADARR_PROFILE_ID / ANIME_RADARR_ROOT_FOLDER
|
no | — | Optional anime Radarr profile id / root folder override |
See Anime Requests.
Some settings live only on the dashboard (persisted to the database):
- Radarr / Sonarr connections — direct URL + API key per instance, with optional 4K and default flags (Admin Dashboard)
- Plex connection and invites — Login with Plex, server/library selection, invite cap (Plex Invites)
- Issue notification handlers and channel — who gets issue DMs (Issue Reporting and Re-grab)
- "All seasons" toggle — remove the all-seasons option from the season picker (Requests and Approvals)
VaultRequestrr · Report a bug · MIT licensed