Seerr

Unified request management for Plex, Jellyfin, and Emby

Overview

Seerr is the unified media request manager that merges Overseerr and Jellyseerr into a single application, maintained by the seerr-team. It provides native support for Plex, Jellyfin, and Emby media servers with an intuitive interface for users to discover and request movies and TV shows. Requests are automatically forwarded to Sonarr and Radarr for download. User quota management, approval workflows, and extensive notification support (Discord, Slack, email, Telegram, Pushover) make Seerr the definitive content request tool for shared media servers.

QuickBox Pro installs Seerr per user from the official seerr-team/seerr GitHub repository, building with Node.js 22.11.0 and pnpm 10.24.0. The installer creates isolated virtual environments, configures systemd service management, and sets up nginx reverse proxy access.

Key features

When to use it

Installation

Install from the QuickBox CLI

qb install seerr -u username

Install with a domain (optional)

To publish Seerr at https://domain, combine lecert with the Seerr flag:

qb install lecert --seerr -d domain -u username

Or, run on the install of Seerr using the domain flag:

qb install seerr -u username -d 'domain'

The lecert workflow copies subdomain.nginx.conf, injects the Seerr port from the database, and writes /etc/nginx/sites-enabled/username.seerr.conf with the provided domain and certificate paths. When DNS credentials are configured (e.g., Cloudflare, Route53, DigitalOcean), the installer automatically detects them and uses DNS challenge validation.

Migrate from Overseerr or Jellyseerr

Seerr includes a built-in migration utility that preserves your settings, database, port assignment, nginx configuration, and URL overrides:

# Migrate from Jellyseerr
qb install seerr -u username --migrate --from jellyseerr
 
# Migrate from Overseerr
qb install seerr -u username --migrate --from overseerr

The migration process:

1. Backs up the source application
2. Stops the old service
3. Copies settings.json and db.sqlite3 to the new Seerr install
4. Preserves the original port assignment
5. Creates new nginx configs from Seerr templates
6. Migrates URL override entries
7. Removes old database entries, service files, and install directories
8. Reloads systemd and nginx

Initial Configuration

First-Time Setup

On first access, Seerr prompts you to connect your media server:

1. Open Seerr web interface at http://host:port
2. Select Media Server Type: Choose Jellyfin, Emby, or Plex
3. Authenticate: Sign in with your media server account
4. Select Server: Pick your media server from the list
5. Library Sync: Seerr automatically scans your media libraries
6. Admin Assignment: First user to sign in becomes the administrator

Connect Sonarr and Radarr

Configure media management integrations for automatic request handling:

1. Navigate to Settings > Services in Seerr
2. Add Radarr Server:
   • Default Server - Enable for primary Radarr instance
   • Server Name - Descriptive name (e.g., “QuickBox Radarr”)
   • Hostname or IP - localhost
   • Port - Your Radarr port (default 7878)
   • Use SSL - Uncheck (reverse proxy handles SSL)
   • API Key - Copy from Radarr > Settings > General > API Key
   • Quality Profile - Select default profile
   • Root Folder - Select default media path
   • Minimum Availability - Released, In Cinemas, or Announced
   • Click Test to verify connection, then Save
3. Add Sonarr Server:
   • Follow same steps as Radarr
   • Port - Your Sonarr port (default 8989)
   • API Key - Copy from Sonarr > Settings > General > API Key
   • Quality Profile - Select default profile (e.g., “HD-1080p”)
   • Root Folder - Select TV shows path
   • Season Folder - Enable for organized library structure
   • Click Test, then Save

Configure Notifications

Set up notification channels for request updates:

1. Go to Settings > Notifications
2. Discord Integration (recommended):
   • Create Discord webhook in your server
   • Enter Webhook URL
   • Enable notification types: Media Requested, Media Approved, Media Available, Media Failed
   • Click Test to send test notification
   • Save Changes
3. Email Notifications (optional):
   • Configure SMTP Settings (host, port, credentials)
   • Set From Email Address
   • Enable desired notification types
   • Save Changes

Access and authentication

URL / route

• Default: http://host:5055 (served by /etc/nginx/software/username.seerr.conf proxying to 127.0.0.1:5055)
• With domain: https://domain/ (served by /etc/nginx/sites-enabled/username.seerr.conf when installed with --seerr -d domain from lecert, or qb install seerr -u username -d domain)

Security notes

• The service runs as username via seerr@username.service and reads environment settings from /opt/username/Seerr/env.conf
• TLS is provisioned when lecert installs certificates into /etc/nginx/ssl/domain/ and binds them in the generated vhost
• First user to sign in becomes the administrator with full permissions
• Additional users inherit permissions based on their media server role
• Webpush notifications are enabled by default during installation

Configuration and files

Common tasks

Service Management

Seerr runs as a per-user systemd service seerr@username:

# Start/stop/restart service
systemctl start seerr@username
systemctl stop seerr@username
systemctl restart seerr@username
 
# Check service status
systemctl status seerr@username
 
# View live logs
journalctl -u seerr@username -f
 
# Enable/disable auto-start on boot
systemctl enable seerr@username
systemctl disable seerr@username

Application Management

Use QuickBox CLI for application updates and maintenance:

# Update to latest release
qb update seerr -u username
 
# Reinstall (preserves database)
qb reinstall seerr -u username
 
# Remove application
qb remove seerr -u username
 
# View help
qb help seerr

nginx Management

Reload nginx after configuration changes:

# Test configuration
sudo nginx -t
 
# Reload nginx
sudo systemctl reload nginx

FAQ

Best practices

Troubleshooting

Related Applications

Resources