Overseerr Media Requests

Key Features

• Native Plex authentication integration with user permission inheritance and role-based access control
• Real-time synchronization with Sonarr and Radarr APIs for automated request processing and status updates
• Advanced request approval workflows with customizable auto-approval rules based on user groups and content ratings
• Comprehensive notification system supporting Discord, Telegram, email, and webhook integrations for request status updates
• Intelligent duplicate detection that checks existing Plex libraries and pending requests before processing new submissions
• Multi-language subtitle preference management with automatic matching to Sonarr and Radarr quality profiles
• Built-in TMDB integration for rich metadata display, trailers, and content discovery recommendations
• Quota management system allowing administrators to set per-user request limits and seasonal restrictions

Common Use Cases

• 1Family media servers where parents want to approve children's content requests while allowing automatic processing of adult selections
• 2Small community media sharing groups requiring democratic content selection with centralized technical management
• 3Home lab environments testing automated media workflows and exploring integration between Plex ecosystem components
• 4Remote media access scenarios where users need a mobile-friendly interface for requesting content while away from home
• 5Multi-user Plex servers seeking to reduce administrator workload through automated request processing and user self-service
• 6Media library migration projects where users can request re-acquisition of content in higher quality or different formats
• 7Educational environments demonstrating modern DevOps practices through containerized media automation stacks

Prerequisites

• Running Plex Media Server instance with administrative access for authentication configuration and library integration
• Functional Sonarr and Radarr installations with configured download clients and indexers for automated media acquisition
• TMDB API key for metadata fetching, content discovery, and poster artwork display functionality
• Minimum 2GB available RAM as Overseerr requires approximately 512MB base memory plus additional overhead for concurrent user sessions
• Port 5055 available on host system for web interface access, with additional firewall configuration if accessing remotely
• Basic understanding of Plex user management, quality profiles in Sonarr/Radarr, and media automation workflow concepts

docker-compose.yml

1services: 
2  overseerr: 
3    image: linuxserver/overseerr:latest
4    container_name: overseerr
5    environment: 
6      - PUID=1000
7      - PGID=1000
8      - TZ=${TZ}
9    volumes: 
10      - overseerr_config:/config
11    ports: 
12      - "5055:5055"
13    restart: unless-stopped
14    networks: 
15      - overseerr-network
16
17volumes: 
18  overseerr_config: 
19
20networks: 
21  overseerr-network: 
22    driver: bridge

.env Template

1# Overseerr
2TZ=UTC

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  overseerr:
5    image: linuxserver/overseerr:latest
6    container_name: overseerr
7    environment:
8      - PUID=1000
9      - PGID=1000
10      - TZ=${TZ}
11    volumes:
12      - overseerr_config:/config
13    ports:
14      - "5055:5055"
15    restart: unless-stopped
16    networks:
17      - overseerr-network
18
19volumes:
20  overseerr_config:
21
22networks:
23  overseerr-network:
24    driver: bridge
25EOF
26
27# 2. Create the .env file
28cat > .env << 'EOF'
29# Overseerr
30TZ=UTC
31EOF
32
33# 3. Start the services
34docker compose up -d
35
36# 4. View logs
37docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/overseerr-requests/run | bash

Troubleshooting