From f52fdf747ccf71c5e32bdcedfc36492d7b2a940d Mon Sep 17 00:00:00 2001
From: nessi <sascha@nesterovic.cc>
Date: Thu, 13 Aug 2026 11:02:12 +0200
Subject: [PATCH] feat: add .env configuration with example template and update
 documentation

Add .env.example template with all configuration options (Radarr, Sonarr, SABnzbd). Move environment variables from docker-compose.yml to .env file for easier configuration management. Add .gitignore for .env, data/, and Python cache files. Update README with setup instructions for copying .env.example and configuring services. Replace hardcoded volume paths with environment variables in docker-compose.yml.
---
 .env.example       | 19 +++++++++++++++++++
 .gitignore         |  4 ++++
 README.md          | 14 +++++++++++++-
 docker-compose.yml | 29 +++++------------------------
 4 files changed, 41 insertions(+), 25 deletions(-)
 create mode 100644 .env.example
 create mode 100644 .gitignore

diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..3bef3c4
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,19 @@
+RADARR_URL=http://radarr:7878
+RADARR_API_KEY=CHANGE_ME
+RADARR_MEDIA_PATH=/data/filme
+LOCAL_MEDIA_PATH=/media/filme
+FILM_MEDIA_VOLUME=/nesflix/filme
+
+# Optional: Sonarr aktivieren
+# SONARR_URL=http://sonarr:8989
+# SONARR_API_KEY=CHANGE_ME
+# SONARR_MEDIA_PATH=/data/serien
+# LOCAL_SERIES_PATH=/media/serien
+# SERIES_MEDIA_VOLUME=/nesflix/serien
+
+# Optional: SABnzbd aktivieren
+# SAB_URL=http://sabnzbd:8080
+# SAB_API_KEY=CHANGE_ME
+
+DB_PATH=/data/cache.db
+LOG_LEVEL=INFO
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..b6bde21
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,4 @@
+.env
+data/
+__pycache__/
+*.pyc
diff --git a/README.md b/README.md
index 7f177be..c02e4f3 100644
--- a/README.md
+++ b/README.md
@@ -22,9 +22,21 @@ wird dadurch für ffprobe zu:
 
 `/media/filme/Avatar (2009)/Avatar.mkv`
 
+## Konfiguration
+
+Die persönlichen URLs, Pfade und API-Keys liegen in `.env`. Diese Datei ist in `.gitignore` eingetragen und bleibt bei `git pull` erhalten. Als Vorlage dient `.env.example`.
+
+Beim ersten Start:
+
+```bash
+cp .env.example .env
+```
+
+Danach die Werte in `.env` eintragen. Sonarr und SABnzbd werden dort durch Auskommentieren der jeweiligen Variablen aktiviert.
+
 ## Start
 
-API-Key und ggf. Docker-Netz in `docker-compose.yml` anpassen:
+API-Keys und Pfade in `.env` anpassen:
 
 ```bash
 docker compose down
diff --git a/docker-compose.yml b/docker-compose.yml
index e84dad3..8eff039 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -5,32 +5,13 @@ services:
     restart: unless-stopped
     ports:
       - "8099:8099"
-    environment:
-      RADARR_URL: "http://radarr:7878"
-      RADARR_API_KEY: "CHANGE_ME"
-
-      # Optional: Sonarr aktivieren (auskommentieren und Werte anpassen)
-      # SONARR_URL: "http://sonarr:8989"
-      # SONARR_API_KEY: "CHANGE_ME"
-
-      # Optional: SABnzbd aktivieren
-      # SAB_URL: "http://sabnzbd:8080"
-      # SAB_API_KEY: "CHANGE_ME"
-
-      # Pfad, den Radarr in seiner API meldet:
-      RADARR_MEDIA_PATH: "/data/filme"
-
-      # Pfad derselben Dateien INNERHALB dieses Containers:
-      LOCAL_MEDIA_PATH: "/media/filme"
-      # SONARR_MEDIA_PATH: "/data/serien"
-      # LOCAL_SERIES_PATH: "/media/serien"
-
-      DB_PATH: "/data/cache.db"
-      LOG_LEVEL: "INFO"
+    env_file:
+      - .env
     volumes:
       # Host-Pfad deiner Film-Library -> interner Dashboard-Pfad
-      - /nesflix/filme:/media/filme:ro
-      # - /nesflix/serien:/media/serien:ro
+      - ${FILM_MEDIA_VOLUME}:/media/filme:ro
+      # Sonarr aktivieren, wenn SERIES_MEDIA_VOLUME gesetzt ist:
+      # - ${SERIES_MEDIA_VOLUME}:/media/serien:ro
       - ./data:/data
     networks:
       - media