Zwei Wege ans Ziel. Beide schnell.

Schritt 1, Docker-Compose-Stack

Auf deinem Linux-Server ein neues Verzeichnis anlegen, compose.yml mit folgendem Inhalt:

services:
  planakte:
    image: ghcr.io/planakte/app:latest
    restart: unless-stopped
    environment:
      PLANAKTE_DOMAIN: akte.dein-buero.de
      PLANAKTE_SECRET: $(openssl rand -hex 32)
      SMTP_HOST: smtp.dein-mailserver.de
      SMTP_USER: planakte@dein-buero.de
      SMTP_PASS: ...
    volumes:
      - ./data:/var/lib/planakte
    ports: ["3000:3000"]

Schritt 2, Image holen, Migration laufen

# Image ziehen
docker compose pull

# Schema migrieren
docker compose run --rm planakte planakte migrate

# Starten
docker compose up -d

Schritt 3, Reverse-Proxy mit Caddy

Empfohlene Konfiguration für Caddyfile (Auto-TLS via Let's Encrypt):

akte.dein-buero.de {
  encode zstd gzip
  reverse_proxy localhost:3000
  header {
    Strict-Transport-Security "max-age=63072000; includeSubDomains"
    X-Content-Type-Options nosniff
    Referrer-Policy strict-origin-when-cross-origin
  }
}

Schritt 4, Erster Admin-Account

docker compose exec planakte planakte admin:create \
  --email du@dein-buero.de \
  --name "Lukas Geschäftsleitung"

Du bekommst einen Magic-Link auf der CLI. Anklicken, einloggen, fertig.

Backups

Backupst du deinen Server schon? Dann backupst du auch Planakte, das Volume ./data enthält alles. Wir empfehlen tägliche verschlüsselte Snapshots zusätzlich. Beispiel mit borg:

0 3 * * * borg create --compression zstd \
  /backups/planakte::{hostname}-{now} ./data

Updates

Major-Updates kommen quartalsweise, mit Migrations-Skripten und CHANGELOG.md. Minor-Updates wöchentlich, automatisch via Watchtower oder manuell:

docker compose pull
docker compose run --rm planakte planakte migrate
docker compose up -d

Self-Hosting-Support

Für Self-Hoster bieten wir auf Anfrage Support-Pakete: SLA mit Reaktionszeit, dedizierter Kontakt, Telemetrie-Dashboards. Schreib uns an onprem@planakte.de.