A complete Docker-based homelab infrastructure for media management, web services, and system monitoring. This repository contains modular, self-contained Docker Compose stacks for organizing and running all homelab services on TrueNAS Scale with a focus on stability, performance, and data safety.
ARR Stack — Media Automation
Complete media automation ecosystem with VPN-routed services for private downloading and indexing.
Services: Prowlarr (indexer), Radarr/Radarr-4K (movies), Sonarr/Sonarr-4K (TV), Bazarr (subtitles), Questarr (games), Deluge (torrents), SABnzbd (usenet), Flaresolverr (anti-captcha), Tautulli (Plex monitoring), Kometa (metadata)
Key Features:
- All download/indexing services route through VPN (Gluetun + ExpressVPN)
- Separate 4K quality profiles for movies and TV
- Automatic subtitle management
- Plex library monitoring and metadata automation
Ports: 9696 (Prowlarr), 7878 (Radarr), 8989 (Sonarr), 5000 (Questarr), 8112 (Deluge), 8080 (SABnzbd), 8181 (Tautulli), + more
Website Stack — Web Services & Dashboard
Complete web service stack featuring dashboard, request management, and reverse proxy with SSL.
Services: Organizr (dashboard), Ombi (request system), Nginx Proxy Manager (reverse proxy), MariaDB (database), MariaDB Client (utility)
Key Features:
- Centralized dashboard (Organizr) for accessing all services
- User request system for movies/TV (Ombi)
- Automated SSL certificate management (Let's Encrypt)
- Database backend for multiple services
Ports: 85 (Organizr), 3579 (Ombi), 80/82/443 (Nginx Proxy Manager)
Misc Stack — Utilities & Monitoring
Collection of utility and monitoring services for the homelab.
Services: Muse (Discord music bot), Scrutiny (disk health monitoring), Threadfin (IPTV streaming)
Key Features:
- Discord bot for music streaming (YouTube + Spotify)
- Real-time disk health monitoring for all 12 drives
- IPTV/M3U playlist server
Ports: 9090 (Scrutiny), 34400 (Threadfin)
- Docker and Docker Compose installed on TrueNAS Scale
- Portainer (for stack management via UI)
- 32GB RAM, Haswell i7-4790K (or similar)
- 12+ TB storage for media
-
Clone the repository to TrueNAS:
git clone <repo-url> /mnt/Starlink/Stacks/homelab-stacks cd /mnt/Starlink/Stacks/homelab-stacks
-
Configure environment variables for each stack:
# ARR Stack cat > arr-stack/arr-stack.env << EOF OPENVPN_USER=your_expressvpn_username OPENVPN_PASSWORD=your_expressvpn_password KOMETA_PLEXTOKEN=your_plex_token KOMETA_TMDBAPIKEY=your_tmdb_api_key KOMETA_MDBLISTAPIKEY=your_mdblist_api_key KOMETA_TAUTULLIAPIKEY=your_tautulli_api_key KOMETA_RADARRTOKEN=your_radarr_api_key KOMETA_RADARR4KTOKEN=your_radarr_4k_api_key KOMETA_SONARRTOKEN=your_sonarr_api_key EOF # Website Stack cat > website/website.env << EOF DB_NAME=SMXPROD DB_USER=JuniorChange DB_PASSWORD=your_secure_password DB_ROOT_PASSWORD=your_secure_root_password EOF # Misc Stack (if using Muse) cat > misc/misc.env << EOF DISCORD_TOKEN=your_discord_bot_token YOUTUBE_API_KEY=your_youtube_api_key SPOTIFY_CLIENT_ID=your_spotify_client_id SPOTIFY_CLIENT_SECRET=your_spotify_client_secret EOF
-
Import stacks into Portainer:
- Open Portainer:
http://<NAS-IP>:9000 - Go to Stacks → Add Stack
- Select "Git repository"
- Add repository URL and select stack
- Deploy each stack from the root directory
- Open Portainer:
-
Start individual stacks (CLI):
cd arr-stack && docker-compose up -d cd ../website && docker-compose up -d cd ../misc && docker-compose up -d
-
Access the services:
- Dashboard:
http://<NAS-IP>:85(Organizr) - Prowlarr:
http://<NAS-IP>:9696 - Radarr:
http://<NAS-IP>:7878 - Sonarr:
http://<NAS-IP>:8989 - Questarr:
http://<NAS-IP>:5000 - Nginx Proxy Manager:
http://<NAS-IP>:82 - Tautulli:
http://<NAS-IP>:8181 - Scrutiny:
http://<NAS-IP>:9090
- Dashboard:
homelab-stacks/
├── README.md # This file
├── .gitignore # Excludes .env, configs/, etc.
├── .gitattributes # Line ending normalization (LF)
│
├── arr-stack/
│ ├── compose.yaml # Service definitions
│ ├── local.compose.yaml # Local overrides (not committed)
│ ├── arr-stack.env # Credentials (not committed)
│ ├── README.md # Stack documentation
│ └── configs/ # Service configs (not committed, except Kometa config.yml)
│
├── website/
│ ├── compose.yaml # Service definitions
│ ├── local.compose.yaml # Local overrides (not committed)
│ ├── website.env # Credentials (not committed)
│ ├── README.md # Stack documentation
│ └── configs/ # Service configs (not committed)
│
└── misc/
├── compose.yaml # Service definitions
├── local.compose.yaml # Local overrides (not committed)
├── misc.env # Credentials (not committed)
├── README.md # Stack documentation
└── configs/ # Service configs (not committed)
Each stack requires environment variables for credentials and API keys. These are excluded from git for security.
- Create
<stack>.envin each stack directory - Add required variables (see stack-specific READMEs)
- Never commit
.envfiles
ARR Stack (arr-stack.env):
OPENVPN_USER=expressvpn_username
OPENVPN_PASSWORD=expressvpn_password
KOMETA_PLEXTOKEN=plex_token
KOMETA_TMDBAPIKEY=tmdb_api_key
KOMETA_MDBLISTAPIKEY=mdblist_api_key
KOMETA_TAUTULLIAPIKEY=tautulli_api_key
KOMETA_RADARRTOKEN=radarr_api_key
KOMETA_RADARR4KTOKEN=radarr_4k_api_key
KOMETA_SONARRTOKEN=sonarr_api_keyKometa config.yml is committed with <<SECRET>> placeholders. Set the KOMETA_* variables in Portainer (or arr-stack.env). KOMETA_MDBLISTAPIKEY maps to <<MDBLISTAPIKEY>> in the mdblist: block; get the key from your MDBList account at https://mdblist.com/preferences/. Custom universe collections use mdblist_list_<key> pointing at juniorchange's MDBList lists (see arr-stack/README.md).
Website Stack (website.env):
DB_NAME=SMXPROD
DB_USER=JuniorChange
DB_PASSWORD=your_password
DB_ROOT_PASSWORD=your_root_passwordMisc Stack (misc.env):
DISCORD_TOKEN=discord_bot_token
YOUTUBE_API_KEY=youtube_api_key
SPOTIFY_CLIENT_ID=spotify_client_id
SPOTIFY_CLIENT_SECRET=spotify_client_secretGluetun (VPN) ──┬─ Prowlarr ──┐
├─ Radarr ├─ Download to /Downloads
├─ Sonarr │
├─ Questarr │
├─ Deluge ───┘
└─ SABnzbd
MariaDB ────────┬─ Nginx Proxy Manager
└─ Ombi
Plex (external) ┬─ Tautulli
└─ Kometa
- Prowlarr, Radarr, Radarr-4K, Sonarr, Sonarr-4K
- Bazarr, Flaresolverr, Deluge, SABnzbd, Questarr
- All torrent/usenet traffic is private and anonymized
- Organizr, Ombi, Nginx Proxy Manager, MariaDB
- Tautulli, Kometa, Muse, Scrutiny, Threadfin
- Can be exposed via Nginx Proxy Manager with SSL
docker-compose -f arr-stack/compose.yaml logs -f prowlarr
docker-compose -f website/compose.yaml logs -f nginx-proxy-manager
docker-compose -f misc/compose.yaml logs -f scrutinydocker-compose -f arr-stack/compose.yaml -f website/compose.yaml -f misc/compose.yaml downcd arr-stack && docker-compose pull && docker-compose up -d
cd ../website && docker-compose pull && docker-compose up -d
cd ../misc && docker-compose pull && docker-compose up -ddocker exec -it db mysql -u root -pdocker ps -a
docker stats- Verify ExpressVPN credentials in
arr-stack.env - Check VPN config:
arr-stack/configs/gluetun/Toronto.ovpn - View logs:
docker logs gluetun - Ensure TUN device is available:
ls /dev/net/tun
- Check dependencies:
docker ps - View logs:
docker logs <container_name> - Verify
.envfile exists and variables are set - Ensure configs directories exist with proper permissions
- Confirm MariaDB is running:
docker ps | grep db - Check credentials in
website.env - View logs:
docker logs db - Reset database:
docker-compose -f website/compose.yaml down -v && docker-compose -f website/compose.yaml up -d
- Check media libraries:
du -sh /mnt/Starlink/* - Monitor with Scrutiny:
http://<NAS-IP>:9090 - Review download directories
.envfiles are in.gitignore— never commit them- Credentials include: API keys, VPN credentials, database passwords
- If accidentally exposed, immediately rotate all credentials
- Use strong passwords for database and services
- VPN services prevent ISP/local network logging of downloads
- Nginx Proxy Manager controls external access with SSL certificates
- Database is not exposed to external networks
- Organize non-VPN services on isolated Docker network if needed
- All services run as UID 568 (except Nginx Proxy Manager which requires root)
- Volumes mounted read-only where possible
- Capabilities minimized (only Gluetun needs NET_ADMIN for VPN)
- Regular security updates via
docker-compose pull
What to backup:
configs/directories (service configurations).envfiles (keep secure, encrypted)- Custom indexer configs
- Radarr/Sonarr profiles
What NOT to backup:
- Docker images (re-downloadable)
- Downloads/ directories (temporary)
- Log files
Backup command:
for stack in arr-stack website misc; do
tar -czf ${stack}-backup-$(date +%Y%m%d).tar.gz ${stack}/configs/ ${stack}/*.env
done- Media libraries on dedicated storage
- Database on fast SSD
- Downloads on separate volume
- Monitor with
docker stats
- Radarr/Sonarr: 200-400MB each
- MariaDB: 500MB-1GB
- Deluge: 500MB+
- Monitor:
docker stats
- Gluetun adds latency (necessary for privacy)
- Use Nginx Proxy Manager for local service routing
- Direct connections for Plex library access
Server: TrueNAS Scale on Haswell i7-4790K
- CPU: Intel i7-4790K (8 cores)
- RAM: 32GB DDR3
- Storage: 12× HDDs (8×12TB + 4×20TB)
- Network: 10GbE interface + SAS HBA
Docker image and GitHub Actions versions in this repo are updated by Renovate via the scheduled workflow in .github/workflows/renovate.yml (Sundays at 4 AM UTC, or on demand from the Actions tab).
- LinuxServer images (
lscr.io/linuxserver/*) use custom versioning forls###build tags and extended Docker Hub tag pagination — see RENOVATE.md. - Compose files are scanned by the built-in
docker-composemanager only (no duplicate regex manager). - Floating tags such as
organizr/organizr:latestare not updated automatically; pin a version tag inwebsite/compose.yamlif you want Renovate to track Organizr.
Open the Dependency Dashboard issue on GitHub to see pending updates or trigger a manual run.
- Update all images:
docker-compose pull && docker-compose up -d - Check disk health: Scrutiny dashboard
- Review error logs:
docker logs <service>
- Backup configurations
- Review Plex library with Tautulli
- Audit active downloads
- Rotate API keys if exposed
- Check for security updates
- Review VPN connection (Gluetun logs)
- Renovate / dependency updates — LinuxServer tagging, schedules, workflows
Each stack has detailed documentation:
- ARR Stack README — Media automation, VPN routing, setup workflow
- Website Stack README — Web services, SSL, database, dashboard
- Misc Stack README — Utilities, monitoring, music bot
When modifying stacks:
- Test changes in
local.compose.yamlfirst - Update relevant README if ports/volumes change
- Update environment variable documentation
- Only commit
compose.yaml,.gitignore, documentation,.gitattributes, and the sanitized Kometaconfig.yml - Never commit
.env, otherconfigs/trees, or local tooling paths such asmcps/