Jellyseerr (Seerr)

Request management and media discovery for Jellyfin, Emby, and Plex

Overview

Jellyseerr (Seerr) is a free and open-source request management and media discovery tool built to work with your existing Jellyfin, Emby, or Plex media server. 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, Telegram), Seerr streamlines content requests for shared media servers.

QuickBox Pro installs Jellyseerr per user from the official seerr-team/seerr GitHub repository, building with Node.js 22.11.0 and pnpm. The installer creates isolated virtual environments at /opt/username/lib/nodejs/Jellyseerr/.venv, configures systemd service management, and sets up nginx reverse proxy access at /username/jellyseerr.

Key features

When to use it

Installation

Install from the QuickBox CLI

qb install jellyseerr -u username

Install with a domain (optional)

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

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

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

qb install jellyseerr -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.jellyseerr.conf with the provided domain and certificate paths.

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 - https://host/username/jellyseerr
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 (for Plex/Emby)
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:port - https://host/username/jellyseerr (served by /etc/nginx/software/username.jellyseerr.conf → 127.0.0.1:5055)
• With domain: https://domain/ (served by /etc/nginx/sites-enabled/username.jellyseerr.conf when installed with --jellyseerr -d domain from lecert, or qb install jellyseerr -u username -d domain)

Security notes

• The service runs as username via jellyseerr@username.service and reads environment settings from /opt/username/Jellyseerr/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

Configuration and files

Common tasks

Service Management

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

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

Application Management

Use QuickBox CLI for application updates and maintenance:

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

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