This project provides a comprehensive, self-hosted media management and streaming ecosystem. It targets users who want to centralize their media libraries, automate downloads, and leverage AI for personalized recommendations, all within a Dockerized environment. The primary benefit is a unified, automated, and intelligent media consumption experience.

How It Works

The stack orchestrates several specialized Docker containers: Sonarr and Radarr for automated TV and movie management, qBittorrent as the download client, Prowlarr for indexer management, Jellyfin for media streaming, Jellyseerr for managing media requests, and Recommendarr for AI-powered recommendations. A key architectural choice is the integration of VPN support (NordVPN, ExpressVPN, etc.) via Gluetun, routing download traffic through a VPN for privacy. Static container IPs are required for Prowlarr to reliably communicate with Radarr and Sonarr when they are behind the VPN.

Quick Start & Requirements

• Install: docker compose --profile vpn up -d (or --profile no-vpn if not using VPN).
• Prerequisites: Docker v28.0.1+, Docker Compose v2.33.1+. A custom Docker network must be created first: docker network create --subnet 172.20.0.0/16 mynetwork.
• Configuration: Requires VPN credentials (if used), static IPs for Radarr/Sonarr, and potentially OpenAI API keys for Recommendarr.
• Docs: Gluetun VPN Setup Guide, Overseerr Documentation (for Jellyseerr setup).

Highlighted Details

• AI-powered recommendations via Recommendarr, integrating with Sonarr, Radarr, and Jellyfin libraries.
• Optional Nginx reverse proxy setup for unified access and SSL.
• Support for multiple VPN providers (OpenVPN protocol).
• Static IP assignment for containers when VPN is active.

Maintenance & Community

The project is maintained by @navilg. Links to community support or roadmaps are not explicitly provided in the README.

Licensing & Compatibility

The README does not specify a license. The project is intended for educational purposes, and the developers disclaim responsibility for illegal use.

Limitations & Caveats

ARMv7 users may face compatibility issues with Jellyseerr v2.0.x due to dropped container image support; downgrading may be necessary. Jellyseerr/Overseerr has limited official support for subfolder reverse proxy configurations. Deploying without a VPN is strongly discouraged due to potential IP exposure.