Skip to content

Account Linking

Adam Glover edited this page Aug 18, 2026 · 1 revision

Account Linking

Linking is the core idea of VaultRequestrr: every request is submitted to Seerr as the requester's own Seerr user, so their per-user quotas and permissions apply.

How it works

  1. A user runs /movie <title> or /tv <title>.
  2. The bot searches Seerr and shows the results to pick from (TV adds a season picker).
  3. On the user's first request, a popup asks for their Plex username/email.
    • It must match an existing Seerr user — if their account hasn't been imported from Plex yet, they should log into Seerr once first.
  4. The link is saved (SQLite) and written back into Seerr's notification settings, so it's also visible in the Seerr UI.
  5. The request is submitted with that user's userId, so Seerr applies their quota/permissions.

From then on, every request, issue, and invite from that Discord user is attributed to their Seerr account automatically.

Managing links

  • Users can check their link with /linkstatus and remove it with /unlink (they'll be asked again on the next request).
  • Admins can unlink or remap any user on the Admin Dashboard Links page, and set per-user Plex Invites caps there.

Disabling the link requirement

Set REQUIRE_LINKING=false to let users request without linking. Unattributed requests then fall back to DEFAULT_SEERR_USER_ID — a single shared Seerr user, which means shared quota. See Configuration.

Troubleshooting

"No Seerr user found" on link — the Plex username/email must match an existing Seerr user. Have the user sign into Seerr once with Plex so their account is imported, then retry.

More in Troubleshooting and FAQ.

Clone this wiki locally