Zum Inhalt springen

Doku · Quickstart

Ein Befehl bis zum nutzbaren Login

Der stehende Vertrag des Repositorys: docker compose up auf einem frischen Clone führt ohne jede Konfiguration zu einem nutzbaren Login. Alles Weitere ist Detail rund um diesen einen Befehl.

Bevor Sie starten

  • Docker Engine mit Compose-Plugin. Docker Desktop ist in Ordnung. Der Stack baut beim ersten Start lokal; jeder aktuelle Rechner mit rund 8 GB freiem RAM reicht bequem.
  • Optional: ein Mistral-API-Schlüssel für Modellfunktionen. Auch ohne läuft der Stack: Login, Erfassung, Dashboard und Queue funktionieren, und Modellaufrufe schlagen mit einem typisierten Fehler fehl, statt etwas vorzutäuschen.
  • Node 22 und npm nur, wenn Sie entwickeln. Zum Betrieb des Stacks nicht nötig.
  1. 1

    Klonen und starten

    Der erste Start baut die Images und initialisiert die Identität, das dauert ein bis zwei Minuten.

    git clone https://github.com/Cogeto/cogeto.git
cd cogeto
docker compose up
  2. 2

    Öffnen und anmelden

    Der Dev-Edge liefert ein selbstsigniertes Zertifikat einer lokalen Zertifizierungsstelle aus, Ihr Browser warnt deshalb einmal. Akzeptieren Sie es.

    Öffnen Sie https://localhost und melden Sie sich als Dev-Bootstrap-Admin an: admin@cogeto.localhost mit dem Passwort DevPassword1! Sie sehen Ihre eigene Instanz.

  3. 3

    Modellschlüssel hinzufügen

    Kopieren Sie .env.example nach .env, setzen Sie Ihren Schlüssel und starten Sie den Stack erneut. Dev-Standardwerte sind nur für localhost sicher; ein Preflight-Container verweigert bekannte Dev-Secrets auf jeder Nicht-localhost-Domain.

    cp .env.example .env
docker compose up -d

Die Ana-Sandbox

Eine fiktive Beraterin mit Wochen an angesammeltem Wissen, eingespielt über die echte öffentliche API: Widersprüche zum Auflösen, abgelaufene Fakten, eine signierte Löschquittung. Das Zugangspasswort gibt der Seed-Job aus. Führen Sie das Demo-Profil nie auf einer Instanz mit echten Daten aus.

COGETO_DEMO_MODE=1 docker compose --profile demo up --build
docker compose logs demo-seed

Wenn etwas nicht stimmt

Port 80 oder 443 ist schon belegt

Ein anderer Webserver läuft. Stoppen Sie ihn oder ändern Sie die veröffentlichten Ports in einem Compose-Override.

Chat oder Extraktion liefert einen Model-Gateway-Fehler

Es ist kein Modell-API-Schlüssel gesetzt. Das ist ohne Schlüssel das vorgesehene Verhalten, kein Absturz.

Ein einmaliger Init-Container zeigt exited (0)

Normal. Preflight, Datenbank-Init, Migrationen, Storage-Init und Identity-Init laufen einmal pro Start und beenden sich.

Von vorn beginnen

docker compose down -v löscht alle Daten, einschließlich Signaturschlüssel der Instanz und Quittungen. Auf einer Dev-Maschine in Ordnung; auf einer echten Instanz nie die Antwort.

docker compose down -v löscht alles, einschließlich des Signaturschlüssels der Instanz und der Quittungskette. Auf einer echten Instanz ist die Antwort immer die geprobte Wiederherstellung aus dem Backup, nie das Löschen.

Wie es weitergeht

Wenn die Evaluation Sie überzeugt, ist Produktion ein anderer, sichererer Weg: signierte Images und ein Operator-Skript.

Selbst gehostet, in ProduktionLokal ausführen, die vollständige Referenz

Lieber zuerst auf Ihren Dokumenten sehen?

Das Pilotprojekt liest einen echten Dokumentenbestand von Ihnen und endet mit dem signierten Befundbericht.

Pilot startenZurück zu allen Wegen