CWA can now autodetect if it's deployed via Docker for Windows or Docker for Mac and will adjust the monitoring scripts to use polling instead of inotify accordingly.

[bug] Ingest Not Triggering Automatically when hosted on Docker for Windows or Docker for Maxc
Fixes #402

Author: crocodilestick

CONTRIBUTORS

@@ -1,7 +1,7 @@
 CONTRIBUTORS
 
 This file is automatically generated. DO NOT EDIT MANUALLY.
-Generated on: 2025-08-19T15:15:09.492072Z
+Generated on: 2025-08-19T15:26:49.024475Z
 
 Upstream project: https://github.com/janeczku/calibre-web
 Fork project (Calibre-Web Automated, since 2024): https://github.com/crocodilestick/calibre-web-automated
@@ -289,7 +289,7 @@ Copyright (C) 2024-2025 Calibre-Web Automated contributors
 - zhiyue (1 commits)
 # Fork Contributors (crocodilestick/calibre-web-automated)
 
-- crocodilestick (515 commits)
+- crocodilestick (518 commits)
 - jmarmstrong1207 (73 commits)
 - demitrix (30 commits)
 - sirwolfgang (22 commits)

README.md

@@ -93,8 +93,9 @@ This tells CWA to avoid enabling WAL on the Calibre `metadata.db` and the `app.d
 
 #### File watching on network shares
 
-- By default, CWA uses Linux inotify (via `inotifywait`) to detect new files in the ingest folder with minimal latency and overhead.
+- By default, CWA uses Linux `inotify` (via `inotifywait`) to detect new files in the ingest folder with minimal latency and overhead.
 - On network shares (NFS/SMB), filesystem events can be unreliable or unavailable. When `NETWORK_SHARE_MODE=true` is set, CWA switches the ingest and metadata watcher services to a polling-based watcher that periodically scans for changes. This improves reliability on NAS/network mounts at the cost of slightly higher I/O and up to a few seconds of latency.
+- On Docker Desktop (Windows/macOS), the container runs on a LinuxKit/WSL2 VM and host-mounted paths may not propagate `inotify` events reliably. CWA auto-detects Docker Desktop at startup and prefers the same polling watcher for reliability.
 - Advanced: You can also force polling regardless of share mode by setting `CWA_WATCH_MODE=poll`.
 
 ## **_Features:_**

root/etc/s6-overlay/s6-rc.d/cwa-ingest-service/run

@@ -22,6 +22,26 @@ run_fallback() {
         done
 }
 
+# Detect if running under Docker Desktop (Windows/macOS) and prefer polling
+is_docker_desktop() {
+        local osr mounts
+        osr=$(cat /proc/sys/kernel/osrelease 2>/dev/null || true)
+        # WSL2 / Windows kernel markers
+        if echo "$osr" | grep -qi 'microsoft'; then
+                return 0
+        fi
+        # LinuxKit kernel used by Docker Desktop VM
+        if echo "$osr" | grep -qi 'linuxkit'; then
+                return 0
+        fi
+        # Mount hints for Desktop host path mappings
+        mounts=$(cat /proc/self/mountinfo 2>/dev/null || true)
+        if echo "$mounts" | grep -Eqi '/host_mnt/|/Users/|osxfs|virtiofs.*docker'; then
+                return 0
+        fi
+        return 1
+}
+
 # Prefer polling when running over network shares to better handle NFS/SMB semantics
 if [ "${NETWORK_SHARE_MODE,,}" = "true" ] || [ "${NETWORK_SHARE_MODE}" = "1" ] || [ "${NETWORK_SHARE_MODE,,}" = "yes" ] || [ "${NETWORK_SHARE_MODE,,}" = "on" ]; then
         echo "[cwa-ingest-service] NETWORK_SHARE_MODE=true detected; using polling watcher instead of inotify"
@@ -35,6 +55,13 @@ if [ "${CWA_WATCH_MODE:-inotify}" = "poll" ]; then
         exit 0
 fi
 
+# Prefer polling on Docker Desktop (Windows/macOS) for reliable detection on host-mounted paths
+if is_docker_desktop; then
+        echo "[cwa-ingest-service] Docker Desktop environment detected; using polling watcher instead of inotify"
+        run_fallback
+        exit 0
+fi
+
 # Monitor the folder for new files using inotify; on error, switch to fallback.
 (
         set -o pipefail

root/etc/s6-overlay/s6-rc.d/metadata-change-detector/run

@@ -23,6 +23,23 @@ run_fallback() {
         done
 }
 
+# Detect if running under Docker Desktop (Windows/macOS) and prefer polling
+is_docker_desktop() {
+        local osr mounts
+        osr=$(cat /proc/sys/kernel/osrelease 2>/dev/null || true)
+        if echo "$osr" | grep -qi 'microsoft'; then
+                return 0
+        fi
+        if echo "$osr" | grep -qi 'linuxkit'; then
+                return 0
+        fi
+        mounts=$(cat /proc/self/mountinfo 2>/dev/null || true)
+        if echo "$mounts" | grep -Eqi '/host_mnt/|/Users/|osxfs|virtiofs.*docker'; then
+                return 0
+        fi
+        return 1
+}
+
 # Prefer polling when running over network shares to better handle NFS/SMB semantics
 if [ "${NETWORK_SHARE_MODE,,}" = "true" ] || [ "${NETWORK_SHARE_MODE}" = "1" ] || [ "${NETWORK_SHARE_MODE,,}" = "yes" ] || [ "${NETWORK_SHARE_MODE,,}" = "on" ]; then
         echo "[metadata-change-detector] NETWORK_SHARE_MODE=true detected; using polling watcher instead of inotify"
@@ -36,6 +53,13 @@ if [ "${CWA_WATCH_MODE:-inotify}" = "poll" ]; then
         exit 0
 fi
 
+# Prefer polling on Docker Desktop (Windows/macOS) for reliable detection on host-mounted paths
+if is_docker_desktop; then
+        echo "[metadata-change-detector] Docker Desktop environment detected; using polling watcher instead of inotify"
+        run_fallback
+        exit 0
+fi
+
 (
         set -o pipefail
         s6-setuidgid abc inotifywait -m -e close_write -e moved_to --exclude '^.*\.(swp)$' "$WATCH_FOLDER" |