Docker Compose Dauerbetrieb¶

Du hast Kamerplanter im Schnellstart ausprobiert und möchtest es jetzt dauerhaft betreiben? Diese Anleitung zeigt dir, wie du Kamerplanter auf einem eigenen Server einrichtest — zum Beispiel auf einem Raspberry Pi, einem NAS oder einem Heimserver.

Unterschied zum Schnellstart¶

Im Schnellstart hast du Kamerplanter aus dem Quellcode gebaut (docker compose up). Für den Dauerbetrieb nutzt du stattdessen fertig gebaute Images — das ist schneller, braucht weniger Speicher und du musst den Quellcode nicht auf dem Server haben.

Voraussetzungen¶

• Ein Server mit Docker und Docker Compose (siehe Installation)
• Mindestens 2 GB RAM (4 GB empfohlen)
• Stabile Netzwerkverbindung für den Download der Images

1. Projektdateien herunterladen¶

Du brauchst nur zwei Dateien vom Repository — nicht den gesamten Quellcode:

# Verzeichnis erstellen
mkdir -p ~/kamerplanter && cd ~/kamerplanter

# Die beiden benötigten Dateien herunterladen
curl -O https://raw.githubusercontent.com/nolte/kamerplanter/main/docker-compose.release.yml
curl -O https://raw.githubusercontent.com/nolte/kamerplanter/main/.env.example

2. Konfiguration erstellen¶

cp .env.example .env

Öffne die .env-Datei und setze sichere Passwörter:

# Sichere Passwörter generieren: openssl rand -base64 24
ARANGO_ROOT_PASSWORD=hier-sicheres-passwort-einsetzen
ARANGODB_PASSWORD=hier-sicheres-passwort-einsetzen

# Standardwerte — nur bei Bedarf ändern
ARANGODB_DATABASE=kamerplanter
ARANGODB_USERNAME=root
REDIS_URL=redis://valkey:6379/0
DEBUG=false
# Fehlt die Zeile, gilt true; ohne ausgehenden Mailversand ausdrücklich false
REQUIRE_EMAIL_VERIFICATION=false
CORS_ORIGINS=["http://localhost:8080"]

Vier zusätzliche Pflicht-Secrets (sonst startet das Backend nicht)¶

Erzeuge die vier Werte und trage sie in deine .env ein:

# JWT_SECRET_KEY, ERASURE_TOMBSTONE_SALT und LOG_PSEUDONYM_SALT (je mind. 32 Zeichen)
openssl rand -hex 32

# FERNET_KEY (muss ein gültiger Fernet-Schlüssel sein)
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

JWT_SECRET_KEY=<Ausgabe von openssl rand -hex 32>
FERNET_KEY=<Ausgabe des Fernet-Kommandos>
ERASURE_TOMBSTONE_SALT=<zweite Ausgabe von openssl rand -hex 32>
LOG_PSEUDONYM_SALT=<dritte Ausgabe von openssl rand -hex 32>

Lege zusätzlich eine docker-compose.override.yml neben docker-compose.release.yml an — Docker Compose lädt sie automatisch mit:

services:
  backend:
    environment:
      JWT_SECRET_KEY: ${JWT_SECRET_KEY}
      FERNET_KEY: ${FERNET_KEY}
      ERASURE_TOMBSTONE_SALT: ${ERASURE_TOMBSTONE_SALT}
      LOG_PSEUDONYM_SALT: ${LOG_PSEUDONYM_SALT}
  celery-worker:
    environment:
      FERNET_KEY: ${FERNET_KEY}
      ERASURE_TOMBSTONE_SALT: ${ERASURE_TOMBSTONE_SALT}
      LOG_PSEUDONYM_SALT: ${LOG_PSEUDONYM_SALT}
  celery-beat:
    environment:
      FERNET_KEY: ${FERNET_KEY}
      ERASURE_TOMBSTONE_SALT: ${ERASURE_TOMBSTONE_SALT}

Vollständige Übersicht aller Pflicht-Secrets je Funktion: Konfigurationsmatrix — Pflicht-Secrets.

3. Version festlegen¶

In der Datei docker-compose.release.yml steht als Platzhalter __VERSION__. Ersetze ihn durch die gewünschte Version:

# Beispiel: Version 1.0.0 setzen
sed -i 's/__VERSION__/1.0.0/g' docker-compose.release.yml

4. Starten¶

docker compose -f docker-compose.release.yml -f docker-compose.override.yml up -d

Prüfe den Status:

docker compose -f docker-compose.release.yml -f docker-compose.override.yml ps

Alle Dienste sollten nach 30–60 Sekunden als running oder healthy angezeigt werden.

5. Zugriff testen¶

Öffne im Browser:

• Kamerplanter: http://dein-server:8080
• API-Dokumentation: http://dein-server:8000/api/v1/docs

Auf dem Server selbst setzt du localhost statt dein-server ein. Von jedem anderen Gerät aus antworten diese Adressen erst, wenn du die beiden Ports geöffnet hast — siehe Zugriff von anderen Geräten; bis dahin sind sie an 127.0.0.1 gebunden, und ein anderes Gerät bekommt „Verbindung abgelehnt".

Automatischer Neustart¶

Die Release-Konfiguration enthält bereits restart: unless-stopped für alle Dienste. Das bedeutet:

• Nach einem Serverabsturz oder Neustart startet Docker die Dienste automatisch
• Dienste, die du bewusst mit docker compose stop anhältst, bleiben gestoppt

Damit Docker selbst nach einem Neustart automatisch startet:

sudo systemctl enable docker

Updates durchführen¶

So aktualisierst du Kamerplanter auf eine neue Version:

cd ~/kamerplanter

# 1. Version in der Compose-Datei aktualisieren
sed -i 's/alte-version/neue-version/g' docker-compose.release.yml

# 2. Neue Images herunterladen und Dienste neu starten
docker compose -f docker-compose.release.yml -f docker-compose.override.yml pull
docker compose -f docker-compose.release.yml -f docker-compose.override.yml up -d

# 3. Alte, nicht mehr benötigte Images aufräumen (optional)
docker image prune -f

Datensicherung¶

Die Daten von Kamerplanter liegen in zwei Docker Volumes:

• arangodb_data — Alle Pflanzen, Standorte, Aufgaben und Konfigurationen
• valkey_data — Cache und Aufgaben-Warteschlange (nicht kritisch, wird automatisch neu aufgebaut)

Sicherung erstellen¶

# ArangoDB-Daten sichern
docker compose -f docker-compose.release.yml -f docker-compose.override.yml exec arangodb \
  arangodump --server.password "$ARANGO_ROOT_PASSWORD" \
  --output-directory /tmp/backup --overwrite true

# Backup aus dem Container kopieren
docker compose -f docker-compose.release.yml -f docker-compose.override.yml cp \
  arangodb:/tmp/backup ./backup-$(date +%Y%m%d)

Sicherung wiederherstellen¶

# Backup in den Container kopieren
docker compose -f docker-compose.release.yml -f docker-compose.override.yml cp \
  ./backup-20260317 arangodb:/tmp/backup

# Daten wiederherstellen
docker compose -f docker-compose.release.yml -f docker-compose.override.yml exec arangodb \
  arangorestore --server.password "$ARANGO_ROOT_PASSWORD" \
  --input-directory /tmp/backup --overwrite true

Zugriff von anderen Geräten¶

Standardmäßig ist Kamerplanter nur über den Server selbst erreichbar: docker-compose.release.yml bindet jeden Port an 127.0.0.1. Um von Smartphone, Tablet oder anderen Rechnern im Heimnetz zuzugreifen:

1. Öffne Benutzeroberfläche und API für dein Netzwerk. Ergänze diese Zeile in der .env:

   .env

   KAMERPLANTER_BIND_ADDRESS=0.0.0.0
   

   Damit öffnest du genau zwei Ports: die Benutzeroberfläche (8080) und die API (8000), mit der ein Home-Assistant-Rechner in deinem Netzwerk spricht. Datenbanken, Valkey und Ollama bleiben nur vom Server aus erreichbar, egal was du hier einträgst.

   Hat der Server mehr als ein Netzwerk (ein VPN, eine zweite Netzwerkkarte, eine öffentliche Adresse), trag statt 0.0.0.0 die Heimnetz-Adresse des Servers ein — etwa KAMERPLANTER_BIND_ADDRESS=192.168.1.100 —, dann öffnen sich die Ports nur in diesem Netz.

   Danach kann jeder in deinem Netzwerk Kamerplanter benutzen

   Die Release-Datei läuft im Light-Modus, der keine Anmeldung kennt. Sobald die Ports offen sind, kann jedes Gerät in deinem Netzwerk deine Daten lesen und ändern. Mach das nur in einem Heimnetz, dem du vertraust, hinter der Firewall deines Routers — nie mit einer Portweiterleitung ins Internet. Details: Light-Modus.

2. Finde die IP-Adresse deines Servers:

   hostname -I
   

3. Öffne auf dem anderen Gerät den Browser und gehe zu http://<IP-Adresse>:8080

4. Passe die CORS-Einstellung in .env an, damit die API Anfragen von der neuen Adresse akzeptiert:

   .env

   CORS_ORIGINS=["http://localhost:8080","http://192.168.1.100:8080"]
   

5. Starte die Dienste nach der Änderung neu:

   docker compose -f docker-compose.release.yml -f docker-compose.override.yml up -d
   

Nächste Schritte¶

• Onboarding-Wizard — Deine ersten Pflanzen einrichten
• Benutzerhandbuch — Alle Funktionen im Detail
• Kubernetes-Deployment — Für professionelle Umgebungen mit Hochverfügbarkeit

Fehlerbehebung¶