AutoPlexx - Fully Automated Plex Media Server Setup

A fully automated Plex Media Server ecosystem using Docker and Docker Compose.

Prerequisites

• Docker and Docker Compose (v2+)
• A Plex account and claim token
• A VPN provider account (for Transmission)

Getting Started

1. Clone the repository:

   git clone https://github.com/joshdev8/AutoPlexx.git
   cd AutoPlexx

2. Copy .env.example to .env and fill in your values:

   cp .env.example .env

   Note: Tracearr requires DB_PASSWORD, JWT_SECRET, and COOKIE_SECRET to be set or it will fail to start.

3. Update the volume paths in docker-compose.yml to match your hard drive mount points.

4. Start all services:

   docker compose up -d

Services

Media Server

Service	Description	Port
Plex	Central media server	32400 (host network)
Kometa	Automates metadata curation, collections, and overlays	N/A (scheduled task)

Content Management

Service	Description	Port
Seerr	Content request and management interface	5055
Watchlistarr	Syncs Plex watchlist to Radarr/Sonarr	N/A
Cleanarr	Finds and removes duplicate content	N/A
Requestrr	Discord bot for content requests	4545

Downloading

Service	Description	Port
Transmission	Torrent client with VPN support	9091

Monitoring

Service	Description	Port
Tautulli	Plex usage monitoring	8181
Grafana	Metrics visualization	3000
Telegraf	Metrics collection agent	N/A
Tracearr	Stream tracking and account sharing detection	3001

Infrastructure

Service	Description	Port
Watchtower	Automated container updates	N/A
TimescaleDB	Time-series database (used by Tracearr)	N/A (internal)
Redis	Cache/queue (used by Tracearr)	N/A (internal)

Not included but recommended

These services pair well with this stack but are not included in the default docker-compose.yml. See their respective docs to add them:

• Radarr - Movie management and downloading
• Sonarr - TV show management and downloading
• Lidarr - Music management and downloading
• Bazarr - Subtitle management
• Prowlarr - Indexer management for Radarr/Sonarr
• Jackett - Torrent indexer aggregator
• Portainer - Docker management UI

Network Architecture

Services are isolated into separate Docker networks:

• monitoring_network - Tautulli, Grafana, Telegraf, Watchtower
• media_network - Seerr
• download_network - Transmission, Watchlistarr, Cleanarr, Requestrr
• tracearr-network - Tracearr, TimescaleDB, Redis

Plex runs in host network mode for optimal streaming performance.

Kometa Configuration

The plex-meta-manager/config/ directory contains Kometa configurations for automated collection and overlay management:

• Movies - IMDb Top 250, TMDb trending, Trakt lists, Oscar categories, genre collections, streaming service collections, holiday collections, and more
• TV Shows - Popular/trending, streaming networks, genres, studios (Marvel, DC), year-based collections
• Playlists - Daily rotating playlists by genre (Action, Comedy, Animated, Family)
• Overlays - Resolution badges (4K, 1080p, 720p), HDR/Dolby Vision, IMDb Top 250, streaming service badges, show status (Airing/Ended/Canceled)