Skip to content
Blockbusterr

Jellyseerr Integration

Multi-User Request Workflow

Jellyseerr integration enables request-based workflows perfect for multi-user environments.

Overview

Section titled “Overview”

When using Jellyseerr mode, Blockbusterr creates requests in Jellyseerr instead of directly adding to Radarr/Sonarr. This gives you an approval workflow.

What is Jellyseerr?

Jellyseerr is a request management system for Plex/Jellyfin that allows users to request content and admins to approve/deny requests before downloading.

Website: jellyseerr.dev

Why Use It?

  • Multi-user request management
  • Approval workflows
  • Request quotas per user
  • User permissions
  • Request history tracking
  • Discord/email notifications

Prerequisites

Section titled “Prerequisites”
  1. Running Jellyseerr instance (v1.0.0+)
  2. Jellyseerr configured with Radarr and/or Sonarr
  3. Jellyseerr API key from settings

Installation

Section titled “Installation”

Add Jellyseerr to your compose stack:

version: '3.8'


networks:
  media:
    driver: bridge


services:
  blockbusterr:
    image: ghcr.io/mahcks/blockbusterr:latest
    container_name: blockbusterr
    networks:
      - media
    ports:
      - "9090:9090"
    volumes:
      - ./blockbusterr/data:/app/data
    environment:
      - TZ=America/New_York
    restart: unless-stopped


  jellyseerr:
    image: fallenbagel/jellyseerr:latest
    container_name: jellyseerr
    networks:
      - media
    ports:
      - "5055:5055"
    volumes:
      - ./jellyseerr/config:/app/config
    environment:
      - TZ=America/New_York
    restart: unless-stopped


  radarr:
    image: linuxserver/radarr:latest
    container_name: radarr
    networks:
      - media
    # ... radarr config


  sonarr:
    image: linuxserver/sonarr:latest
    container_name: sonarr
    networks:
      - media
    # ... sonarr config

Getting API Key

Section titled “Getting API Key”

  1. Open Jellyseerr web interface at http://localhost:5055

  2. Click your profile icon (top right)

  3. Go to Settings → General

  4. Scroll to API Key section

  5. Click Generate API Key if not already generated

  6. Copy the API key

Configuration

Section titled “Configuration”

Minimal configuration to enable Jellyseerr:

integration:
  mode: "jellyseerr"  # Use Jellyseerr mode


jellyseerr:
  enabled: true
  url: "http://jellyseerr:5055"
  api_key: "your_jellyseerr_api_key"
  1. Add configuration to config.yaml
  2. Restart Blockbusterr
  3. Verify connection in logs
  4. Enable jobs to start creating requests

Testing Connection

Section titled “Testing Connection”

Test the connection with curl:

Terminal window
curl "http://jellyseerr:5055/api/v1/status" \
  -H "X-Api-Key: YOUR_API_KEY"

Expected response:

{
  "version": "1.9.2",
  "commitTag": "v1.9.2",
  "updateAvailable": false,
  "commitsBehind": 0
}

Configuring Jellyseerr

Section titled “Configuring Jellyseerr”

  1. Add Radarr to Jellyseerr:

    • Settings → Radarr → Add Radarr Server
    • Enter Radarr URL and API key
    • Select quality profile and root folder
    • Test connection

  2. Add Sonarr to Jellyseerr:

    • Settings → Sonarr → Add Sonarr Server
    • Enter Sonarr URL and API key
    • Select quality profile and root folder
    • Test connection

  3. Configure Auto-Approve (Optional):

    • Settings → Users → Select user
    • Enable Auto-Approve Movies
    • Enable Auto-Approve TV Shows
    • Or set approval thresholds

  4. Set Request Limits (Optional):

    • Settings → Users → Select user
    • Set Movie Request Limit (e.g., 10 per week)
    • Set TV Request Limit (e.g., 5 per week)

Request Workflow

Section titled “Request Workflow”

  1. Blockbusterr job runs (e.g., trending_movies)

  2. Content fetched from Trakt

  3. Filters applied - content must pass Blockbusterr filters

  4. Score threshold - content must meet threshold_score

  5. Request created in Jellyseerr

  6. Jellyseerr shows request in dashboard

  7. Admin reviews and approves/denies

  8. If approved, Jellyseerr sends to Radarr/Sonarr

  9. Radarr/Sonarr searches and downloads

Example Configurations

Section titled “Example Configurations”

Scenario: Multiple users with approval workflow.

integration:
  mode: "jellyseerr"


jellyseerr:
  enabled: true
  url: "http://jellyseerr:5055"
  api_key: "your_key"
  user_id: 1  # Admin creates requests


jobs:
  family_movies:
    type: "movie"
    list_type: "trakt_popular"
    enabled: true
    schedule: "0 8 * * *"  # Daily at 8 AM
    fetch_count: 50
    threshold_score: 65

In Jellyseerr:

  • Kids: 5 requests/week, manual approval
  • Parents: Auto-approve enabled

Result: 10-15 movie requests daily, family reviews together

Monitoring Requests

Section titled “Monitoring Requests”

Jellyseerr Dashboard

View all requests, their status (pending/approved/declined), and requester

Blockbusterr Activity

Check what Blockbusterr has created in the Activity log

Request Notifications

Configure Discord/Email notifications in Jellyseerr for new requests

Troubleshooting

Section titled “Troubleshooting”

Problem: Can’t connect to Jellyseerr

  1. Check Jellyseerr is running:

    Terminal window
    docker ps | grep jellyseerr

  2. Verify network connectivity:

    Terminal window
    docker exec blockbusterr ping jellyseerr

  3. Test API key:

    Terminal window
    curl "http://jellyseerr:5055/api/v1/status" -H "X-Api-Key: YOUR_KEY"

  4. Check Blockbusterr logs:

    Terminal window
    docker logs blockbusterr

Next Steps

Section titled “Next Steps”

Integration Modes

Learn about Direct vs Jellyseerr modes

Configure Jobs

Set up automated content discovery

Use Cases

See real-world examples

Jellyseerr Docs

Official Jellyseerr documentation