Docker Compose Schnellstart¶

In 5 Minuten von Null zur laufenden Kamerplanter-Instanz mit deinen ersten Pflanzen.

1. Repository herunterladen¶

Lade den Quellcode herunter und wechsle in das Verzeichnis:

git clone https://github.com/nolte/kamerplanter.git
cd kamerplanter

2. Konfiguration erstellen¶

Kopiere die Beispiel-Konfiguration und passe die Passwörter an:

cp .env.example .env

Öffne die Datei .env in einem Texteditor und ändere mindestens die Passwörter:

# Sichere Passwörter setzen (mindestens 12 Zeichen empfohlen)
ARANGO_ROOT_PASSWORD=dein-sicheres-passwort    # (1)!
ARANGODB_PASSWORD=dein-sicheres-passwort        # (2)!

1. Das Passwort für die Datenbank. Wähle ein sicheres Passwort — es wird nicht im Browser angezeigt.
2. Muss identisch mit ARANGO_ROOT_PASSWORD sein.

openssl rand -base64 24

Die übrigen Einstellungen kannst du zunächst auf den Standardwerten belassen.

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

Erzeuge die vier Werte:

# 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())"

Trage die vier Werte in deine .env ein:

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 an, die diese Werte tatsächlich an die Container durchreicht (Docker Compose lädt sie automatisch mit, sobald sie im selben Verzeichnis liegt):

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}

3. Kamerplanter starten¶

Starte alle Dienste mit einem einzigen Befehl:

docker compose up -d

Docker lädt beim ersten Start die benötigten Images herunter. Das kann je nach Internetverbindung 2–5 Minuten dauern. Bei weiteren Starts geht es deutlich schneller.

Prüfe, ob alle Dienste laufen:

docker compose ps

Du solltest fünf Dienste sehen, alle mit dem Status running oder healthy:

NAME                  STATUS
kamerplanter-arangodb-1        running (healthy)
kamerplanter-valkey-1          running (healthy)
kamerplanter-backend-1         running (healthy)
kamerplanter-celery-worker-1   running
kamerplanter-celery-beat-1     running
kamerplanter-frontend-1        running (healthy)

docker compose logs backend

4. Kamerplanter im Browser öffnen¶

Öffne deinen Browser und gehe zu:

http://localhost:8080

Da Kamerplanter standardmäßig im Light-Modus startet, gibt es keinen Login-Bildschirm — du landest direkt im Onboarding-Wizard.

5. Erste Einrichtung¶

Beim ersten Öffnen startet Kamerplanter automatisch den Onboarding-Wizard. Er führt dich in wenigen Minuten durch Erfahrungsstufe, Standort und die Wahl eines Starter-Kits (z. B. "Fensterbrett-Kräuter" oder "Zimmerpflanzen-Starter"). Alles ist selbsterklärend und im Detail beschrieben auf der Seite Onboarding-Wizard.

Geschafft!¶

Dein Kamerplanter läuft. Von hier aus kannst du:

• Pflanzen ansehen und den Wachstumsstatus verfolgen
• Aufgaben prüfen, die das Starter-Kit angelegt hat
• Standorte anpassen — Räume umbenennen, weitere hinzufügen
• Weitere Pflanzen anlegen — über das Menü "Stammdaten"

Optionale Profile (KI, Sensordaten)¶

Der Basis-Start mit docker compose up -d reicht für den vollständigen Pflanzen-, Aufgaben- und Pflegebetrieb. Zusätzliche Funktionen — KI-Wissensassistent und Sensordaten-Historie — können über optionale Docker Compose Profile zugeschaltet werden.

Übersicht der Profile¶

Beispiel-Befehle¶

Nur Basis (Standard — kein Profil nötig):

docker compose up -d

KI-Wissensassistent mit lokalem LLM (Ollama):

docker compose --profile vectordb --profile ollama up -d

Aktiviere anschließend die Dienste in der .env:

VECTORDB_ENABLED=true
LLM_PROVIDER=ollama
LLM_API_URL=http://ollama:11434
LLM_MODEL=llama3.2          # Beliebiges auf Ollama verfügbares Modell

KI-Wissensassistent mit Cloud-LLM (z. B. Anthropic):

docker compose --profile vectordb up -d

VECTORDB_ENABLED=true
LLM_PROVIDER=anthropic
LLM_API_KEY=sk-ant-...
LLM_MODEL=claude-sonnet-4-20250514

Sensordaten-Historie:

docker compose --profile timescaledb up -d

TIMESCALEDB_ENABLED=true

Ressourcenbedarf der Profile¶

Nützliche Befehle¶

Zugangspunkte¶

Standard (immer verfügbar)¶

Optional (nur mit aktiviertem Profil)¶

Siehe auch¶

• Onboarding-Wizard — Ausführliche Beschreibung aller Wizard-Schritte
• Light-Modus — Was der Light-Modus genau bedeutet
• Erstes Deployment — Kamerplanter dauerhaft auf eigenem Server betreiben