From 4272c847f7676841f1ffd186206a591be6fe7a8f Mon Sep 17 00:00:00 2001
From: JB <jb-apps@outlook.com>
Date: Mon, 22 Dec 2025 06:42:00 -0800
Subject: [PATCH] feat: Add network mode configuration for Docker in .env and
 docker-compose

---
 .env.example        | 6 ++++++
 docker-compose.yaml | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/.env.example b/.env.example
index 9a33129..341d28b 100644
--- a/.env.example
+++ b/.env.example
@@ -26,6 +26,12 @@ ABOGEN_TEMP_DIR=./storage/tmp
 ABOGEN_UID=1000
 ABOGEN_GID=1000
 
+# Network mode for the Docker container. Options:
+#   bridge (default) - Isolated container network, uses port mapping
+#   host             - Container uses host's network directly, required for
+#                      accessing LAN resources like Calibre OPDS servers
+# ABOGEN_NETWORK_MODE=host
+
 # Optional: Seed the web UI with working defaults for the LLM-powered
 # text normalization features. Leave these blank to configure everything
 # from the Settings page.
diff --git a/docker-compose.yaml b/docker-compose.yaml
index e47e6ec..256b11d 100644
--- a/docker-compose.yaml
+++ b/docker-compose.yaml
@@ -8,6 +8,11 @@
 #
 # Access the web interface at http://localhost:8808
 #
+# Network modes:
+#   - Set ABOGEN_NETWORK_MODE=host in .env to use host networking
+#     (required for accessing LAN resources like Calibre OPDS)
+#   - Leave unset or use "bridge" for isolated container networking
+#
 services:
   abogen:
     build:
@@ -19,6 +24,7 @@ services:
         USE_GPU: ${USE_GPU:-true}
     image: abogen:latest
     user: "${ABOGEN_UID:-1000}:${ABOGEN_GID:-1000}"
+    network_mode: ${ABOGEN_NETWORK_MODE:-bridge}
     ports:
       - "${ABOGEN_PORT:-8808}:8808"
     volumes: