Skip to Content
Overseerr

Overseerr

Request management and media discovery for Plex

Overseerr is a free and open-source request management and media discovery tool built to work with your existing Plex ecosystem. It provides an intuitive interface for users to discover and request movies and TV shows, which are then automatically sent to Sonarr and Radarr for download. With user quota management, approval workflows, and extensive notification support (Discord, Slack, email), Overseerr streamlines content requests for shared Plex servers. QuickBox Pro installs Overseerr from official GitHub releases with Node.js 16.20.2, systemd service, and nginx reverse proxy.

Deprecated -- Use Seerr

Overseerr has been unified into Seerr, the canonical media request manager for Plex, Jellyfin, and Emby. New installations should use qb install seerr -u username. Existing Overseerr installations are automatically migrated when you run qb update overseerr -u username. This page is retained for reference only.

Plex Integration

Native Plex authentication with automatic library scanning and metadata sync

Sonarr/Radarr Integration

Automatic request forwarding to your media management tools

User Management

Request quotas, approval workflows, and granular permissions per user

Notifications

Discord, Slack, email, Telegram, and Pushover notifications for requests and approvals

Media Discovery

Browse popular, trending, and upcoming content from TMDb with rich metadata

Request Tracking

Track request status, approval history, and download progress in real-time


Installation

Install Seerr instead

For new servers, install Seerr — the unified replacement with native Plex, Jellyfin, and Emby support — rather than Overseerr. The instructions below are retained for existing installations and for reference.

Install from the Dashboard

Open App Dashboard → Package Management (/dashboard?mode=packages), find Overseerr in the catalog, and click Install. The dashboard streams the install log live and the app appears in your Application Control panel when it finishes. Reinstall, Update, and Remove are available from the same panel — running Update automatically migrates the install to Seerr.

What you see is gated by your account: admins manage any user’s apps; regular users manage their own. See App Management for the full flow.

Install from the CLI (automation)

qb help overseerr qb install overseerr -u username qb reinstall overseerr -u username qb update overseerr -u username # auto-migrates to Seerr qb remove overseerr -u username

Full flag reference: CLI Reference. Overseerr binds port 5055 per user (accessed at https://your-server-ip/username/overseerr).


Accessing Overseerr

After installation, access Overseerr at:

https://your-server-ip/username/overseerr
QuickBox Dashboard Integration

Overseerr is automatically integrated into your QuickBox dashboard. Find it in the Service Control panel with port and status information. Click the LAUNCH icon to open the web interface.

First-Time Setup:

  1. Sign in with your Plex account
  2. Connect to Sonarr and Radarr
  3. Configure notification channels (Discord, Slack, email)
  4. Set user quotas and approval workflows
  5. Start requesting content!

Initial Configuration

Sign in with Plex, connect Sonarr and Radarr, and configure notifications exactly as on Seerr — follow Initial Configuration on the Seerr page. The interface is the same; on an existing Overseerr install the URL path is /username/overseerr and the service is overseerr@username.


Service Management

Overseerr runs as a per-user systemd service.

systemctl status overseerr@username # Check status systemctl restart overseerr@username # Restart service journalctl -u overseerr@username -f # View live logs systemctl enable overseerr@username # Start on boot (already enabled) systemctl disable overseerr@username # Prevent auto-start

Troubleshooting

Migrating to Seerr and the install timed out?

If qb update overseerr -u username (or the auto-migration it triggers) aborts with Timed out waiting for /opt/username/Seerr/config/settings.json after 60s, the failure is in the Seerr first-boot step, not Overseerr itself. See the dedicated recovery steps on the Seerr troubleshooting page.

Update left `/opt/username/Seerr` missing?

If an older update run wiped your install directory and you see cd: /opt/username/Seerr: No such file or directory, your last-known-good settings and request database are still on disk under /home/username/.QuickBox/software/seerr/backup/. Follow Recover from an update wipe on the Seerr page to reinstall and restore them.

Overseerr Won’t Start

journalctl -u overseerr@username -f

Check Node.js virtual environment:

/opt/username/lib/nodejs/Overseerr/.venv/bin/node --version # Should show Node.js v16.20.2 # Verify environment ls -la /opt/username/lib/nodejs/Overseerr/.venv/bin/ # If venv broken, reinstall: qb reinstall overseerr -u username

Cannot Sign In with Plex

Symptoms

  • Plex authentication fails or times out
  • Redirected to Plex.tv but authentication doesn't complete
  • Error: 'Unable to connect to Plex server'
  • Plex servers not appearing in server list

Resolution

  • Verify Plex Media Server is running: systemctl status plexmediaserver
  • Check Plex is accessible at http://localhost:32400/web
  • Ensure Plex account has admin access to the server
  • Clear browser cookies and try signing in again
  • Check nginx reverse proxy: sudo nginx -t && sudo systemctl reload nginx

For request-flow problems (Sonarr/Radarr connection, requests not forwarding, Discord notifications, quota enforcement) the diagnosis is identical to Seerr — see Troubleshooting on the Seerr page, substituting overseerr@username for the service name.


Best Practices

The operational best practices are the same as Seerr — see Best practices on the Seerr page. The most important one for a deprecated Overseerr install: migrate to Seerr by running qb update overseerr -u username, which carries over your settings, database, and port.


Media Servers

Media Management


Additional Resources


Join the Community

Media server operators sharing configs, getting support, and shaping the future of QuickBox Pro.

Dedicated Support
Feature Previews
Community Configs
Active Discussions
Join Discord Server
Last updated on