Selbst gehostete Cloud

Verbinde dich mit deinem eigenen Contextify Cloud-Server.

Selbst gehostete Cloud richtet sich an Nutzer, die die Synchronisierungs-API und das Dashboard auf eigener Infrastruktur betreiben möchten. Sobald der Server läuft, ist die Client-Einrichtung einfach: Nutze die Server-URL und einen API-Schlüssel mit Synchronisierungsberechtigung.

Diese Seite erklärt, wie du einen Client mit einem bestehenden selbst gehosteten Server verbindest. Um den Server von Grund auf einzurichten, folge der Anleitung zur Self-Hosted-Einrichtung. Sie führt dich durch Start und Absicherung des Docker-Stacks, die Verbindung mit Contextify und die Prüfung von Suche und Recall.

Was du brauchst

Server-URL

Nutze die vom Client erreichbare Server-URL mit dem richtigen Schema und Port. Bei Tailscale- oder reinen VPN-Setups kann dies ein Tailnet-Hostname statt einer öffentlich erreichbaren Internetadresse sein.

API-Schlüssel

Erstelle im selbst gehosteten Dashboard einen API-Schlüssel mit Synchronisierungsberechtigung. Schlüssel mit reiner Suchberechtigung reichen zum Hochladen nicht aus.

Zustandsprüfung

Der Server sollte unter /api/v1/health antworten, bevor du einen Client einrichtest.

Prüfe den Serverzustand

Rufe den Health-Endpunkt von einem Gerät auf, das den Server erreichen kann:

curl -s https://your-server.example.com/api/v1/health

Ein funktionsfähiger selbst gehosteter Server antwortet mit:

{"status": "ok", "self_hosted": true}

self_hosted ist bei einer selbst gehosteten Installation true und bei der gehosteten Contextify Cloud false. Prüfe damit, ob die konfigurierte URL auf den erwarteten Server zeigt.

Verbinde die Mac-App

Öffne Settings → Cloud

Wähle Contextify Cloud Self-Hosted.
Gib die Server-URL ein

Nutze denselben Hostnamen, den das TLS-Zertifikat des Servers abdeckt. Bei Tailscale HTTPS ist das meist ein Hostname unter .ts.net.
Füge den API-Schlüssel ein

Die App prüft den selbst gehosteten Server und den API-Schlüssel, bevor sie die gespeicherte gehostete Verbindung auf diesem Mac ersetzt.
Speichere und prüfe den Status

Der Tab Cloud sollte den selbst gehosteten Anbieter, die Server-URL und den Synchronisierungsstatus anzeigen. Wenn die App noch einen umfangreichen lokalen Verlauf erfasst, kann die Synchronisierung bis zum Abschluss der lokalen Verarbeitung warten.

Verbinde dich über die CLI

Nutze nach Möglichkeit die interaktive Eingabe, damit kein API-Schlüssel im Shell-Verlauf landet.

contextify cloud setup --url https://your-server.example.com
contextify cloud status --json
contextify cloud sync

Für die Einrichtung ohne interaktive Eingabe wird --key unterstützt. Behandle Befehlsprotokolle als vertraulich, wenn sie einen echten Schlüssel enthalten.

contextify cloud setup --url https://your-server.example.com --key ctx_REDACTED --no-input

Wenn dein selbst gehosteter Server nur innerhalb eines VPN oder Tailnets erreichbar ist, führe diese Befehle von einem Gerät in diesem Netzwerk aus.

Server-Einrichtung im Überblick

Der selbst gehostete Server führt den Docker-Stack contextify-cloud mit Docker Compose und PostgreSQL aus, wobei SELF_HOSTED=true gesetzt ist. Die Anleitung zur Self-Hosted-Einrichtung erklärt die gesamte Einrichtung: den öffentlichen Quellcode klonen, Geheimnisse setzen, den Stack starten und das Eigentümerkonto erstellen.

Das unterstützte HTTPS-Setup nutzt einen stabilen Hostnamen in deinem Netzwerk, TLS-Terminierung vor der API und eine Weiterleitung auf den Loopback-Port des API-Containers. Der reine HTTP-Modus dient zur Prüfung in vertrauenswürdigen Netzwerken und ist nicht das bevorzugte dauerhafte Setup.

Häufiger erster Fehler

Der häufigste Self-Hosted-Fehler betrifft die Erreichbarkeit des konkreten Ziels: Der Mac hat Internetzugang, kann aber den selbst gehosteten Hostnamen nicht auflösen oder erreichen.

Anleitung zu TLS, VPN und Tailscale lesen

Lies mehr zu Erfassung und Synchronisierung, wenn die Verbindung funktioniert, die Cloud aber noch nicht auf dem aktuellen Stand ist.

Zuletzt aktualisiert: 6. Mai 2026