docs: Portainer-Deployment-Anleitung + docker-compose.portainer.yml

Named-Volume-Compose ohne ENV-Pflichtfelder — Bridge startet im
Offline-Modus, User trägt Drucker-IP in der UI ein.

README.de.md

@@ -105,6 +105,20 @@ Drucker → Verbindungstyp **Moonraker** → Host: `http://BRIDGE-IP:7125`
 
 ---
 
+## 🐳 Portainer
+
+[`docker-compose.portainer.yml`](docker-compose.portainer.yml) in
+**Portainer → Stacks → Add stack → Web editor** einfügen und auf *Deploy* klicken.
+
+Keine Konfiguration nötig — die Bridge startet im Offline-Modus.
+**`http://HOST-IP:7125`** öffnen, den **Drucker-Tab** aufrufen und **+ Drucker hinzufügen** klicken.
+Nur die Drucker-IP eingeben — Zugangsdaten werden automatisch geholt und gespeichert.
+
+Alle Daten (Konfiguration, GCode-Store, Datenbank) liegen in Named Docker Volumes
+(`kx-bridge-config`, `kx-bridge-data`), die Portainer verwaltet.
+
+---
+
 ## 📺 Video-Tutorial
 
 [![KX-Bridge Setup & Usage](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)

README.md

@@ -104,6 +104,20 @@ Printer → Connection type **Moonraker** → Host: `http://BRIDGE-IP:7125`
 
 ---
 
+## 🐳 Portainer
+
+Paste [`docker-compose.portainer.yml`](docker-compose.portainer.yml) into
+**Portainer → Stacks → Add stack → Web editor** and click *Deploy*.
+
+No configuration needed upfront — the bridge starts in offline mode.
+Open **`http://HOST-IP:7125`**, go to the **Printers** tab and click **+ Add printer**.
+Enter the printer's IP address — credentials are fetched and saved automatically.
+
+All data (config, GCode store, database) is stored in named Docker volumes
+(`kx-bridge-config`, `kx-bridge-data`) managed by Portainer.
+
+---
+
 ## 📺 Video Tutorial
 
 [![KX-Bridge Setup & Usage](https://img.youtube.com/vi/1Ql4wfH27fM/hqdefault.jpg)](https://www.youtube.com/watch?v=1Ql4wfH27fM)

docker-compose.portainer.yml

@@ -0,0 +1,29 @@
+# KX-Bridge — Portainer Stack
+#
+# Paste this into Portainer → Stacks → Add stack → Web editor
+#
+# No configuration needed upfront — just deploy, open http://HOST-IP:7125
+# and add your printer via the UI (IP only, credentials are fetched automatically).
+#
+# All data (config, GCode store, database) is stored in named Docker volumes
+# managed by Portainer.
+
+services:
+  kx-bridge:
+    image: gitea.it-drui.de/viewit/kx-bridge:latest
+    volumes:
+      - kx-bridge-config:/app/config
+      - kx-bridge-data:/app/data
+    ports:
+      # Port 7125 = first printer. Add 7126, 7127, … for each additional printer.
+      - "7125:7125"
+    restart: unless-stopped
+    logging:
+      driver: json-file
+      options:
+        max-size: "10m"
+        max-file: "3"
+
+volumes:
+  kx-bridge-config:
+  kx-bridge-data: