nfoguard/CONFIGURATION.md

NFOGuard Configuration Guide

⚠️ IMPORTANT: All paths must be configured via environment variables

NFOGuard has zero hardcoded paths - everything must be explicitly configured in your environment variables to match your specific setup.

Required Environment Variables

Media Paths (REQUIRED)

# Container paths (what NFOGuard sees inside the Docker container)
MOVIE_PATHS=/your/container/movie/path1,/your/container/movie/path2
TV_PATHS=/your/container/tv/path1,/your/container/tv/path2

# External service paths (what Radarr/Sonarr see on the host)
RADARR_ROOT_FOLDERS=/host/radarr/path1,/host/radarr/path2  
SONARR_ROOT_FOLDERS=/host/sonarr/path1,/host/sonarr/path2

Example Configuration

# For a typical setup:
MOVIE_PATHS=/media/Movies/movies,/media/Movies/movies6
TV_PATHS=/media/TV/tv,/media/TV/tv6
RADARR_ROOT_FOLDERS=/mnt/unionfs/Media/Movies/movies,/mnt/unionfs/Media/Movies/movies6
SONARR_ROOT_FOLDERS=/mnt/unionfs/Media/TV/tv,/mnt/unionfs/Media/TV/tv6

Database & Logging

DB_PATH=/app/data/media_dates.db
LOG_DIR=/app/data/logs

Path Mapping Logic

1. Webhook receives path from Radarr: /mnt/unionfs/Media/Movies/movies6/Movie...
2. Matches against RADARR_ROOT_FOLDERS[1]: /mnt/unionfs/Media/Movies/movies6
3. Maps to corresponding MOVIE_PATHS[1]: /media/Movies/movies6
4. Final container path: /media/Movies/movies6/Movie...

Zero Hardcoded Paths

• ✅ No default fallback paths
• ✅ Application fails with clear error if paths not configured
• ✅ Works with any folder structure
• ✅ Completely portable between environments