Central LLM WikiHilfeAnmelden← Zurück
Hilfe · 4 / 5

Selbst hosten

Central LLM Wiki in einer Umgebung betreiben, die du kontrollierst

Deine Installation

Central LLM Wiki ist für den Betrieb auf eigener Infrastruktur gedacht. Die docker-compose.yml des Repositorys startet die Bun-Anwendung und PostgreSQL 16 – auf einem eigenen Docker-Host hinter deinem HTTPS-Reverse-Proxy oder in Coolify. Du legst die öffentliche APP_URL, die Geheimnisse, SMTP für Bestätigungs- und Einladungs-E-Mails sowie deine Sicherungen fest; Konten und Wiki-Inhalte bleiben in deiner Installation. Die Installationsanleitung beschreibt Konfiguration, Updates und Schlüsselwechsel Schritt für Schritt.

Erste Admin-Person und Einladungen

  1. SMTP einrichten, INITIAL_ADMIN_SETUP_TOKEN auf einen Zufallswert setzen (etwa mit openssl rand -hex 32) und neu bereitstellen.
  2. https://orakel.marcobartsch.de/setup öffnen, Token, Name, E-Mail-Adresse und Passwort eingeben und dem Bestätigungslink folgen.
  3. Das Setup-Token wieder leeren und neu bereitstellen. Die Einrichtung ist einmalig und bleibt danach geschlossen.
  4. Anmelden und den Einrichtungsassistenten abschließen. Anschließend lädst du Personen unter Einstellungen → Mitglieder und Rollen ein. Jedes neue Konto, auch mit Google-Anmeldung, braucht eine Einladung für seine E-Mail-Adresse; Einladungen laufen nach 72 Stunden ab.

Optional kann eine Admin-Person den Arbeitsbereich unter Einstellungen → Daten und Integrationen mit einem Multica-Arbeitsbereich verknüpfen, um dessen Projekte zu übernehmen und abzugleichen. Die Synchronisierung ändert nie Mitgliedschaften, Zugangsrechte oder Agent-Zuweisungen.

Agent-Skill installieren

Lade im Einrichtungsassistenten oder unter Einstellungen → Agent verbinden den LLM Wiki Reader für schreibgeschützte Fragen und Recherche oder den LLM Wiki Librarian für Ingest, angeforderte Änderungen, Wartung und Aufgaben zum Speichern von Ergebnissen herunter. Installiere den Skill-Ordner selbst nach der Anleitung deines Agenten; Central LLM Wiki übernimmt die Installation nicht. Behalte den Ordner einschließlich SKILL.md und agents/openai.yaml bei.

Verbinde zusätzlich das passende MCP-Profil central-llm-wiki-read (Reader) oder central-llm-wiki-write (Librarian) mit den nötigen Zugangsdaten und Berechtigungen. Der Skill enthält kein Token und erteilt keine Zugriffsrechte. Setze vor dem Download APP_URL auf die öffentliche App-Adresse, damit das Paket auf den /mcp-Endpunkt dieser Installation verweist.

Der Web-Agent ist optional. Dafür richtest du unter Einstellungen → KI-Anbieter einen Modellanbieter und API-Schlüssel ein. Der Schlüssel liegt verschlüsselt in deiner Datenbank; Anfragen gehen an den ausgewählten Anbieter. Dessen Nutzungsbedingungen und Gebühren gelten. Einstellungen und Statistik zeigen die Tokenzahl und geschätzte Modellkosten.

Ältere Versionen werden standardmäßig 90 Tage aufbewahrt. Mit VERSION_RETENTION_DAYS kannst du den Zeitraum ändern. Das Repository enthält keine Sicherungsautomatik: Sichere das PostgreSQL-Volume mit eigenen Werkzeugen. Die vorgesehene Installation betreibt eine Anwendungsinstanz; Bearer-Zugangsdaten und OAuth erfordern im Produktivbetrieb HTTPS.

Häufige Fragen

Beim Einfügen einer URL wird kein Text gefunden – was nun?
Die Seite hat wahrscheinlich einen Bot-Schutz oder verlangt eine Anmeldung. Seiten, die JavaScript benötigen, ruft der integrierte Browser erneut ab. Falls es weiterhin nicht klappt, füge den Text über „Text einfügen“ ein oder lade ein PDF hoch. Bei Artikeln mit DOI bleiben die Literaturangaben auch dann erhalten, wenn der Volltext nicht geladen werden kann. Bei Plattformen mit Anmeldepflicht, etwa Facebook, musst du den Text selbst einfügen.
Die Registrierung verlangt eine Einladung – warum?
Jedes Konto benötigt eine gültige Einladung für seine E-Mail-Adresse, auch bei der Anmeldung mit Google; eine offene Registrierung gibt es nicht. Bitte eine Admin-Person deiner Installation, dich unter Einstellungen → Mitglieder und Rollen einzuladen. Einladungen laufen nach 72 Stunden ab.
Der lokale automatische Ingest ist fehlgeschlagen – warum?
Das Fortschrittsfenster zeigt den Grund. Häufig begrenzt der Modellanbieter die Anfragen; das System versucht es automatisch dreimal erneut. Bei kostenlosen Kontingenten passiert das besonders oft. Ein kostenpflichtiges Modell ist meist zuverlässiger. Bereits erstellte Seiten bleiben erhalten.
In welcher Sprache schreibt der Agent?
Er richtet sich nach der Sprache des Arbeitsbereichs, die du in den Einstellungen ändern kannst. Regeln unter schema/ können das überschreiben, zum Beispiel: „Zusammenfassungen auf Englisch, meine Kommentare auf Deutsch“. Inhalte sind in jeder Sprache möglich.
Kommen sich ein Remote-Agent und die Weboberfläche in die Quere?
Nein. Wenn dieselbe Seite gleichzeitig bearbeitet wird, erhält die Person, die später speichert, die aktuelle Version und kann ihre Änderungen darauf abstimmen. Der Agent beachtet diese Regel ebenfalls.
Der Agent hat einen Fehler gemacht – was kann ich tun?
Korrigiere die Seite oder stelle eine frühere Version wieder her, weise den Agenten im Chat darauf hin oder halte die gewünschte Vorgehensweise unter schema/ fest.Regeln und Vorlagen
Ich habe keinen API-Schlüssel.
Den brauchst du nicht, wenn du einen MCP-Client wie Cursor oder Claude Code verbindest: Er verwendet seinen eigenen Agenten. Ein Schlüssel unter Einstellungen → KI-Anbieter ist nur für die optionale lokale KI im Browser nötig.
Mein Agent kann nicht schreiben.
Reader-Zugänge und OAuth-Verbindungen sind bewusst nur lesend. Erstelle unter Einstellungen → Agent verbinden einen separaten Librarian-Zugang mit ausdrücklichen Schreibrechten für genau die Bereiche (General oder Projekte), die der Agent braucht.

Hilfe erhalten

Bei Fragen zu deiner Installation wende dich an deren Administration. Fehlerberichte und Vorschläge kannst du als GitHub-Issue einreichen. Weitere Informationen findest du im Quellcode und in der Installationsanleitung auf GitHub.