Seerr Setup Guide

Seerr Setup Guide

Introduction

Seerr is the official successor and unified evolution of Overseerr and Jellyseerr. It provides a modern, high-performance request management and media discovery interface for personal media servers (Plex, Jellyfin, and Emby). It connects directly to Radarr and Sonarr to automate downloads and media organization.

---

Service Definition

# ------------------------------------------------------------------------------
# Seerr - Successor to Overseerr. Drop-in replacement with automatic migration.
# Uses the SAME config folder as Overseerr for seamless migration.
# ------------------------------------------------------------------------------
services:
  seerr:
    container_name: seerr.${HOST_NAME}
    hostname: seerr.${HOST_NAME}.lan
    image: ghcr.io/seerr-team/seerr:latest
    environment:
      TZ: ${TZ}
      PUID: ${PUID}
      PGID: ${PGID}
      DOMAINNAME: ${DOMAINNAME}
    networks:
      - mediaserver
    ports:
      - "${SEERR_PORT}:5055"
    volumes:
      #- ${DOCKERDIR}/overseerr/config:/app/config # Use for Migration Step 1
      - ${DOCKERDIR}/seerr/config:/app/config      # Use after Migration Step 5
      - ${DOCKERDIR}/logs/seerr:/var/log
    restart: always
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test: wget --no-verbose --tries=1 --spider http://localhost:5055/api/v1/settings/public || exit 1
      start_period: 20s
      timeout: 3s
      interval: 15s
      retries: 3
    labels:
      - "com.centurylinklabs.watchtower.enable=true"
      - "homepage.group=Media"
      - "homepage.name=Seerr"
      - "homepage.icon=seerr.png"
      - "homepage.href=https://seerr.${DOMAINNAME}/"
      - "homepage.description=Request and manage your media"
      - "homepage.widget.type=overseerr"
      - "homepage.widget.url=http://seerr.${HOST_NAME}:5055"
      - "homepage.widget.key=${SEERR_API_KEY}"

---

Overseerr → Seerr Migration Procedure

Follow these steps in exact sequence to migrate existing data cleanly:

1. Stop Overseerr:

   docker stop overseerr.${HOST_NAME}

2. Start Seerr against the existing Overseerr directory: Temporarily update volumes in seerr.yaml to point to ${DOCKERDIR}/overseerr/config:/app/config, then launch Seerr:

   docker compose -p mediaserver -f docker-compose-server1.yaml up -d seerr

   Seerr will detect the database and automatically migrate users, requests, settings, and history.

3. Verify Migration in Seerr UI: Navigate to Settings -> About to confirm there are no migration errors. Check that your users and requests are intact.

4. Decommission Overseerr:

   docker stop overseerr.${HOST_NAME}
   docker rm overseerr.${HOST_NAME}

5. Rename the AppData Directory:

   mv ${DOCKERDIR}/appdata/overseerr ${DOCKERDIR}/appdata/seerr

6. Finalize Seerr Configuration: Switch the volume path in seerr.yaml back to ${DOCKERDIR}/seerr/config:/app/config and restart:

   docker compose -p mediaserver -f docker-compose-server1.yaml up -d --force-recreate seerr

---

Recommended Pre-Setup

Before running the Seerr wizard, ensure these backend containers are operational:

• Plex Media Server Setup Guide
• Radarr Setup Guide
• Sonarr Setup Guide
• Tautulli Setup Guide

---

Initial Setup Wizard

Step 1: Sign In & Connect Media Server

1. Navigate to http://<your-ip-address>:5055 (or host port set by ${SEERR_PORT}).
2. Select Sign in with Plex (or your preferred media server).

Step 2: Configure Plex Server & Libraries

1. Seerr will auto-detect your local Plex server. If not detected automatically, enter the hostname or container IP manually under Hostname or IP Address.
2. Click Save Changes.
3. Enable the Plex Libraries you want users to browse and request against.
4. Click Start scan to index existing titles, then select Continue.

---

Step 3: Connecting Services (Radarr & Sonarr)

Radarr Setup (Movies)

1. Navigate to Services and click + Add Radarr Server.
2. Enable Default Server.
3. Fill in:
   • Server Name: Radarr
   • Hostname/IP: radarr (or container IP)
   • Port: 7878
   • API Key: Paste from your .env or Radarr settings.
4. Click Test. Once successful, select your Quality Profile and Root Folder.
5. Set Minimum Availability to Released.
6. Enable Scan, then click Add Server.

Sonarr Setup (TV Shows)

1. Select + Add Sonarr Server.
2. Enable Default Server.
3. Fill in Hostname, Port (8989), and API Key, then click Test.
4. Choose your default Quality Profile and Root Folder.
5. Set up optional Anime profiles or root paths if applicable.
6. Enable Scan and click Add Server.

---

Step 4: Settings & Permissions

1. Go to Settings -> General and copy the API Key into your root .env under ${SEERR_API_KEY} (enabling the Homepage dashboard widget).
2. Go to Users to manage global request rules, auto-approvals, and user permissions.

Step 5: Tautulli Integration

1. Go to Settings -> Plex and scroll to Tautulli Settings.
2. Enter your Tautulli Hostname/IP and API Key.
3. Click Save Changes.

---

Management Commands

• Deploy / Start Service:

  docker compose -p mediaserver -f docker-compose-server1.yaml up -d seerr

• View Live Container Logs:

  docker compose -p mediaserver -f docker-compose-server1.yaml logs -f seerr