From d3e2147982276d8c8bc672bb77ac8c2bc72ceedd Mon Sep 17 00:00:00 2001
From: Froidefond Julien <julienfroidefond@gmail.com>
Date: Fri, 6 Mar 2026 20:49:12 +0100
Subject: [PATCH] feat: make libraries volume path configurable via env
 variable

- Add LIBRARIES_HOST_PATH env variable for Docker volume mount path
- Update docker-compose.yml to use ${LIBRARIES_HOST_PATH:-../libraries}
- Update .env.example with new variable and documentation
- Allows users to customize the host path for their libraries folder
---
 .env.example             | 7 ++++++-
 infra/docker-compose.yml | 4 ++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/.env.example b/.env.example
index 7609f86..ff425ae 100644
--- a/.env.example
+++ b/.env.example
@@ -44,7 +44,12 @@ MEILI_URL=http://meilisearch:7700
 # Storage Configuration
 # =============================================================================
 
-# Path to libraries directory
+# Path to libraries directory inside container
 # In Docker: leave as default /libraries
 # For local dev: set to your local libraries folder path
 LIBRARIES_ROOT_PATH=/libraries
+
+# Path to libraries directory on host machine (for Docker volume mount)
+# Default: ../libraries (relative to infra/docker-compose.yml)
+# You can change this to an absolute path on your machine
+LIBRARIES_HOST_PATH=../libraries
diff --git a/infra/docker-compose.yml b/infra/docker-compose.yml
index 113d01d..47535f3 100644
--- a/infra/docker-compose.yml
+++ b/infra/docker-compose.yml
@@ -56,7 +56,7 @@ services:
     ports:
       - "8080:8080"
     volumes:
-      - ../libraries:/libraries
+      - ${LIBRARIES_HOST_PATH:-../libraries}:/libraries
     depends_on:
       migrate:
         condition: service_completed_successfully
@@ -79,7 +79,7 @@ services:
     ports:
       - "8081:8081"
     volumes:
-      - ../libraries:/libraries
+      - ${LIBRARIES_HOST_PATH:-../libraries}:/libraries
     depends_on:
       migrate:
         condition: service_completed_successfully