Erstes Deployment¶

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
REQUIRE_EMAIL_VERIFICATION=false
CORS_ORIGINS=["http://localhost:8080"]

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 up -d

Prüfe den Status:

docker compose -f docker-compose.release.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

Ersetze dein-server durch die IP-Adresse oder den Hostnamen deines Servers. Wenn du auf dem Server selbst arbeitest, funktioniert localhost.

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 pull
docker compose -f docker-compose.release.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 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 cp \
  arangodb:/tmp/backup ./backup-$(date +%Y%m%d)

Sicherung wiederherstellen¶

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

# Daten wiederherstellen
docker compose -f docker-compose.release.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. Um von Smartphone, Tablet oder anderen Rechnern im Heimnetz zuzugreifen:

1. Finde die IP-Adresse deines Servers:

   hostname -I
   

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

3. 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"]
   

4. Starte die Dienste nach der Änderung neu:

   docker compose -f docker-compose.release.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¶