Kundeo
Selbst hosten

Ihre Daten bleiben bei Ihnen

Node, pnpm und Docker genügen. Nach fünf Befehlen läuft Kundeo auf Ihrer Maschine — mit eigener Postgres-Datenbank und ohne Verbindung nach außen.

DokumentationRepository

Installation

Die Instanz läuft anschließend auf localhost:3000. Für den Betrieb hinter einer Domain setzen Sie einen Reverse Proxy davor.

  • VoraussetzungenNode 20+, pnpm, Docker (oder ein bestehender Postgres 15+)
  • DatenbankDocker Compose startet Postgres auf Port 5432
  • Row-Level SecurityEinmalig prisma/rls.sql anwenden
  • Demodatenpnpm db:seed legt eine Organisation mit Beispieldaten an
Terminal
pnpm install
cp .env.example .env# BETTER_AUTH_SECRET setzen
docker compose up -d# Postgres auf :5432
pnpm db:migrate# Tabellen anlegen
pnpm db:seed# optional: Demodaten
pnpm dev# http://localhost:3000

Betrieb und Datenschutz

Mandantentrennung in der Datenbank

Jede Zeile trägt eine organizationId. Postgres Row-Level Security erzwingt die Trennung, unabhängig von der Anwendung.

Keine externe Abhängigkeit

Kundeo ruft im Betrieb keine fremden Dienste auf. E-Mail-Versand konfigurieren Sie mit Ihrem eigenen SMTP-Server.

Backups

Ein Postgres-Dump genügt. Die Anwendung selbst ist zustandslos und wird als Container ausgeliefert.

Aktualisierung

Migrationen laufen über Prisma. Vor dem Update Dump ziehen, danach pnpm db:migrate.

Auftragsverarbeitung

Beim Selbsthosting sind Sie Verantwortlicher und Verarbeiter zugleich — ein AV-Vertrag mit uns ist nicht erforderlich.

Lizenz

AGPL-3.0-only. Sie dürfen Kundeo betreiben, anpassen und weitergeben; Änderungen am Server müssen Sie offenlegen.

Lieber nicht selbst betreiben?

Eine gehostete Version ist geplant. Bis dahin steht die selbst gehostete Variante vollständig zur Verfügung.

Preise ansehen