From 8c025e9be464aa23e168da25b2e266f795feb246 Mon Sep 17 00:00:00 2001
From: code <code@4lt.ca>
Date: Thu, 30 Jul 2026 21:17:18 +0000
Subject: [PATCH] bazarr_dev: give shared media library its own BAZARR_MEDIA
 var

Media is typically shared with Sonarr/Radarr/Jellyfin, so it shouldn't
be nested under VOL_PATH. Also expand the config volume note.
---
 bazarr_dev/README.md    | 7 ++++---
 bazarr_dev/compose.yaml | 2 +-
 bazarr_dev/sample.env   | 1 +
 3 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/bazarr_dev/README.md b/bazarr_dev/README.md
index 6cfeb4c..95d0bb2 100644
--- a/bazarr_dev/README.md
+++ b/bazarr_dev/README.md
@@ -31,14 +31,15 @@ Bazarr monitors your Sonarr/Radarr libraries. When new media is added or existin
 | `BAZARR_RESTART` | Restart policy (default: `unless-stopped`) |
 | `BAZARR_PORT` | Published port for the web UI (default: `6767`) |
 | `VOL_PATH` | Base path for persistent data volumes (default: `/data`) |
+| `BAZARR_MEDIA` | Path to the shared media library (default: `/data/media`) — point this at the same library used by Sonarr, Radarr, and Jellyfin/etc. so subtitles land next to the video files |
 | `TZ` | Container timezone (default: `America/Vancouver`) |
 
 ## Volume Notes
 
 | Volume | Purpose |
 |---|---|
-| `${VOL_PATH:-/data}/bazarr/config` | Application configuration and database |
-| `${VOL_PATH:-/data}/media` | Shared media library — must include your TV and movie folders so Bazarr can write subtitles alongside video files |
+| `${VOL_PATH:-/data}/bazarr/config` | Application configuration and database — holds `config/config.yaml` (Sonarr/Radarr connections, provider credentials, language profiles) and the SQLite database (`config/db/bazarr.db`) tracking subtitle history and sync state. Back this up before upgrades; losing it means reconfiguring providers and Sonarr/Radarr links from scratch. |
+| `${BAZARR_MEDIA:-/data/media}` | Shared media library, kept separate from `VOL_PATH` since it's typically the same library mounted into Sonarr, Radarr, and Jellyfin/etc. — must include your TV and movie folders so Bazarr can write subtitles alongside video files |
 
 ## Network Notes
 
@@ -59,7 +60,7 @@ docker run -d \
   -e TZ=America/Vancouver \
   -p 6767:6767 \
   -v ${VOL_PATH:-/data}/bazarr/config:/config \
-  -v ${VOL_PATH:-/data}/media:/media \
+  -v ${BAZARR_MEDIA:-/data/media}:/media \
   --network proxy \
   --restart unless-stopped \
   ghcr.io/hotio/bazarr:release
diff --git a/bazarr_dev/compose.yaml b/bazarr_dev/compose.yaml
index ff83ffa..b7fe861 100644
--- a/bazarr_dev/compose.yaml
+++ b/bazarr_dev/compose.yaml
@@ -4,7 +4,7 @@ services:
     restart: ${BAZARR_RESTART:-unless-stopped}
     volumes:
       - ${VOL_PATH:-/data}/bazarr/config:/config
-      - ${VOL_PATH:-/data}/media:/media
+      - ${BAZARR_MEDIA:-/data/media}:/media
     environment:
       - PUID=1000
       - PGID=1000
diff --git a/bazarr_dev/sample.env b/bazarr_dev/sample.env
index db5e2a9..c465aef 100644
--- a/bazarr_dev/sample.env
+++ b/bazarr_dev/sample.env
@@ -4,3 +4,4 @@ BAZARR_IMAGE=ghcr.io/hotio/bazarr:release
 TZ=America/Vancouver
 BAZARR_PORT=6767
 BAZARR_RESTART=unless-stopped
+BAZARR_MEDIA=/data/media