Getting Started

Getting Started

VaultRequestrr needs three things before its first run: a Discord bot token, a Seerr admin API key, and a few environment variables. Once those are in place, pick an install method on Installation.

1. Create a Discord bot

1. Go to https://discord.com/developers/applications → New Application → Bot.
2. Copy the bot token — this becomes DISCORD_TOKEN.
3. Invite the bot to your server with the applications.commands and bot scopes.

No privileged intents are required.

Tip: set DISCORD_GUILD_ID to your server's id so slash commands register instantly. Left blank, commands register globally, which can take up to an hour to appear.

2. Get your Seerr API key

• In Seerr: Settings → General → API Key.
• The key must belong to an admin user — it's needed to look up users and submit requests on their behalf.

3. Configure

cp .env.example .env
# edit .env: DISCORD_TOKEN, SEERR_URL, SEERR_API_KEY
# set DISCORD_GUILD_ID to your server id for instant slash-command registration

Only DISCORD_TOKEN, SEERR_URL, and SEERR_API_KEY are required. Everything else has sensible defaults — see Configuration for the full reference.

4. Run it

Head to Installation for Python, Docker, and Unraid instructions.

5. Recommended next steps

• Set WEB_PASSWORD to enable the Admin Dashboard — most settings (Seerr connection, approvers, webhook, Plex invites, Radarr/Sonarr connections) can be managed there without restarts.
• Configure the Seerr webhook for near-instant DM Notifications.
• Add your admin Discord ids so pending requests reach someone who can approve them — see Requests and Approvals.