From e6e1f67ee73acbc364a49ed69e83dea16cf1f25b Mon Sep 17 00:00:00 2001
From: Jeff Culverhouse <jeff@graystorm.com>
Date: Wed, 5 Nov 2025 11:26:53 -0500
Subject: [PATCH] chore: add README section on /media permissions with Synology

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 5888d26..9e02b12 100644
--- a/README.md
+++ b/README.md
@@ -90,6 +90,28 @@ or make sure you attach a volume with the config file and point to that director
 CMD [ "python", "-u", "./app.py", "-c", "/config" ]
 ```
 
+## Mounted Volume Permissions (Synology)
+
+If you mount a host folder into /media for saving recordings, ensure the container has write access.
+On Synology NAS, shared folders use ACLs that can block Docker containers even when chmod 777 appears open.
+
+To reset permissions and make the volume writable by the container’s default user (uid=1000, gid=1000), run the following via SSH:
+```
+sudo synoacltool -del /volume1/photo/Amcrest
+sudo chmod 777 /volume1/photo/Amcrest
+sudo chown 1000:1000 /volume1/photo/Amcrest
+```
+
+Then verify inside the container:
+```
+docker exec -it amcrest2mqtt ls -ld /media
+```
+
+You should see permissions like:
+```
+drwxrwxrwx 1 appuser appuser ... /media
+```
+
 ## Out of Scope
 
 ### Non-Docker Environments