From 288d2f3db5d0d4f5b1c1d633dc7f10943efe2152 Mon Sep 17 00:00:00 2001
From: "XPS\\Micro" <Rainer Wieland>
Date: Tue, 3 Feb 2026 14:14:47 +0100
Subject: [PATCH] docs: Synology Git Berechtigungsbits Problem dokumentieren
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Erkläre das 'local changes' Fehler-Problem auf Synology
- Ursache: Automatische Berechtigungsänderungen (executable bit)
- Lösung: git checkout <datei> vor git pull
- Zeige Beispiel (old mode 100644 vs new mode 100755)
---
 docs/BUGFIX_CONTAINER_SPAWN.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/BUGFIX_CONTAINER_SPAWN.md b/docs/BUGFIX_CONTAINER_SPAWN.md
index 79baf09..c221929 100644
--- a/docs/BUGFIX_CONTAINER_SPAWN.md
+++ b/docs/BUGFIX_CONTAINER_SPAWN.md
@@ -150,5 +150,35 @@ docker-compose up -d --build
 
 ---
 
+---
+
+## Synology NAS: Git Berechtigungsbits Problem
+
+**Bei `git pull` auf Synology:**
+```bash
+error: Your local changes to the following files would be overwritten by merge:
+        api.py
+        container_manager.py
+```
+
+**Ursache:** Synology ändert automatisch Datei-Berechtigungen (executable bit).
+
+**Lösung:**
+```bash
+# Lokale Berechtigungsänderungen verwerfen
+git checkout api.py container_manager.py
+
+# Dann pull machen
+git pull origin main
+```
+
+Das ist NICHT ein echtes Code-Problem - nur Berechtigungsbits:
+```
+old mode 100644  (nicht ausführbar)
+new mode 100755  (ausführbar)
+```
+
+---
+
 **Dokumentation:** 2026-02-03
 **Getestet auf:** Synology NAS, Docker 20.10+, Docker Compose 2.0+