Betreibe deinen eigenen Contextify Cloud-Server, von Anfang bis Ende.

Schnellster Weg

Lass deine KI die Einrichtung übernehmen

Du nutzt bereits einen Coding-Agenten. Gib ihm diese Anleitung, und er richtet den Server für dich ein. Er führt jeden Befehl in deiner Shell aus und fragt dich bei den wichtigen Entscheidungen. Alles läuft auf deinem Rechner.

Gib deiner KI diesen Prompt

Kopiere diesen Prompt in Claude Code, Codex oder einen anderen Coding-Agenten. Er verweist auf eine Anleitung, die wir aktuell halten. So bleibt der Prompt kurz und beständig.

Help me set up a self-hosted Contextify server on this machine. Read the runbook at https://contextify.sh/docs/self-hosted/agent-setup.md and follow it exactly: run the commands in my shell, show me what you are doing, generate any secrets locally on this machine, and pause to ask me at every step marked [ASK ME]. When it is done, verify the server is healthy and my Contextify app can search across it.

Prompt kopieren

Die Anleitung liegt unter contextify.sh/docs/self-hosted/agent-setup.md. Wenn dein Agent keine URL abrufen kann, öffne sie und füge ihren Inhalt in den Chat ein.

Demnächst: Wenn du die CLI contextify mit Claude Code oder Codex nutzt, wird ein integrierter Einrichtungs-Skill daraus einen einzigen Befehl machen. Er erscheint in einem künftigen Contextify-Release. Nutze bis dahin den Prompt oben.

Selbst einrichten

Bevor du beginnst

Du möchtest die Einrichtung selbst ausführen oder genau lesen, was dein Agent tun würde? Hier sind dieselben vier Schritte von Anfang bis Ende.

Schritt 1: Server starten

Klone den öffentlichen Quellcode und erstelle deine Umgebungsdatei aus dem Beispiel:

git clone https://github.com/PeterPym/contextify-cloud-self-hosted.git
cd contextify-cloud-self-hosted
cp .env.example .env

Setze deine Geheimnisse und URLs in .env

Erzeuge drei Geheimnisse in der Shell und kopiere jeden Wert in .env. Füge keinen Befehl $(...) in die Datei ein: Docker Compose liest .env wörtlich und führt keine Befehle aus. Eine Zeile $(openssl ...) würde deshalb zu deinem tatsächlichen Geheimnis werden.

openssl rand -hex 32    # copy into API_SECRET_KEY
openssl rand -hex 20    # copy into DB_PASSWORD
openssl rand -hex 32    # copy into CONTEXTIFY_SELF_HOSTED_SETUP_TOKEN

Bearbeite dann .env, sodass diese Werte gesetzt sind:

Die Zeile DATABASE_URL in .env.example wird von dieser Compose-Datei ignoriert. Sie bildet ihre eigene Verbindungszeichenfolge aus DB_PASSWORD, du musst die Zeile also nicht bearbeiten. Die Anmeldung erfolgt per Passwort; ein E-Mail-Anbieter ist deshalb optional. Lass RESEND_API_KEY leer, dann werden Anmelde-E-Mails ins Serverprotokoll geschrieben statt gesendet.

Starte den Stack

docker compose -f docker-compose.selfhosted.yml up -d --build

Der erste Durchlauf baut das API-Image. Auf einem kleinen Rechner dauert das einige Minuten. Prüfe den Fortschritt mit docker compose -f docker-compose.selfhosted.yml ps. Die API bindet standardmäßig an Loopback (127.0.0.1:8443); Schritt 2 setzt HTTPS davor.

Prüfe den Zustand

curl -s http://127.0.0.1:8443/api/v1/health

Ein funktionsfähiger selbst gehosteter Server antwortet mit:

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

Du erstellst das Eigentümerkonto in Schritt 2, sobald dein tatsächlicher Hostname und HTTPS eingerichtet sind. So zeigt der Setup-Link auf die Adresse, die deine Rechner wirklich nutzen werden.

Schritt 2: Absichern

Die API lauscht auf einem Loopback-Port. Du erreichst sie über HTTPS unter einem stabilen Hostnamen mit passendem TLS-Zertifikat. Empfohlen ist Tailscale HTTPS: Es setzt HTTPS vor den Loopback-Port der API unter einem Hostnamen .ts.net, der in deinem privaten Tailnet bleibt. Der Server wird also nie dem öffentlichen Internet zugänglich gemacht. Der vom Zertifikat bestätigte Hostname ist der Name, mit dem du Contextify konfigurierst. Den Server über einen eigenen Reverse-Proxy öffentlich erreichbar zu machen, ist eine fortgeschrittene Option. Dabei verantwortest du die Absicherung von TLS, Anmeldung und Rate-Limiting. Halte ihn privat, wenn du keinen konkreten Grund dagegen hast.

Anleitung zu TLS, VPN und Tailscale lesen

Passe die Konfiguration an die endgültige URL an

Sobald HTTPS vorgeschaltet ist, prüfe, dass der Server für genau diese Origin konfiguriert ist:

• Prüfe die URL-Variablen

  Prüfe, dass ALLOWED_ORIGINS, EMAIL_BASE_URL und INVITATION_BASE_URL in .env alle deiner endgültigen HTTPS-Origin entsprechen.

• Aktiviere sichere Cookies

  Setze FORCE_SECURE_COOKIES=true in .env. Im Beispiel ist der Wert zur lokalen HTTP-Prüfung auf false gesetzt.

• Übernimm die Änderungen

  Führe docker compose -f docker-compose.selfhosted.yml up -d erneut aus, damit der Container die aktualisierte Umgebung übernimmt.

Erstelle das Eigentümerkonto

Personal Self-Hosted ist für einen einzelnen Nutzer bestimmt. Dieses erste Konto ist der Eigentümer des Servers. Erstelle es einmal unter deinem tatsächlichen HTTPS-Hostnamen. Öffne entweder die einmalige Einrichtungsseite in einem Browser:

https://your-server.example.ts.net/setup?token=YOUR_SETUP_TOKEN

Oder erstelle bei einem Server ohne grafische Oberfläche das Eigentümerkonto über die Kommandozeile:

docker compose -f docker-compose.selfhosted.yml exec api \
  python -m contextify_cloud create-admin --email you@example.com

Schritt 3: Contextify verbinden

Wenn der Server läuft und erreichbar ist, verbinde deine Rechner. Nutze die Server-URL und einen im Dashboard erstellten API-Schlüssel mit Synchronisierungsberechtigung.

Vollständige Verbindungsanleitung lesen

Wenn dein Server nur innerhalb eines VPN oder Tailnets erreichbar ist, führe die Verbindungsbefehle auf einem Gerät in diesem Netzwerk aus.

Schritt 4: Suche und Recall prüfen

Prüfe von einem verbundenen Rechner aus, ob der gesamte Weg hin und zurück funktioniert.

• Prüfe die Synchronisierung

  Führe contextify cloud status --json aus und prüfe, ob aktuelle Projekte synchronisiert wurden. Du kannst auch das schreibgeschützte Dashboard unter deiner Server-URL öffnen.

• Durchsuche deinen Verlauf

  Suche in der Mac-App oder im Dashboard nach einem Begriff, der sicher in einer früheren Sitzung vorkommt. Die Ergebnisse kommen von dem Server, den du betreibst.

• Abruf durch deinen Assistenten

  Nutze Total Recall, um eine frühere Entscheidung, Fehlerbehebung oder Debugging-Sitzung in deine aktuelle Arbeit zu holen: /total-recall in Claude Code, $total-recall in Codex.

Weiter geht’s