Open WebUI: einen Ordner synchronisieren mit oikb

Dokumente von Hand in eine Open WebUI-Wissensbasis zu importieren, funktioniert, solange sich der Ordner nicht ändert. Sobald er lebt (aktualisierte Verfahren, hinzugefügte Notizen, entfernte Dateien), driftet die Wissensbasis ab und das Modell antwortet auf Basis veralteter Versionen. Einen Ordner mit Open WebUI über oikb zu synchronisieren, das Tool, das im Bereich Ecosystem der offiziellen Dokumentation vorgestellt wird, soll diese Abweichung beheben. Diese Anleitung erklärt das Prinzip der inkrementellen Synchronisation, was sie löschen kann, und ein vorsichtiges Vorgehen: Backup, eingeschränkter Umfang, Testbasis. Sie wurde von der Redaktion nicht getestet.
#Warum einen Ordner mit Open WebUI synchronisieren
Eine Wissensdatenbank (Knowledge) von Open WebUI ist eine Sammlung von Dateien, die in Abschnitte zerlegt und als Embeddings indexiert werden. Wenn Sie diese Wissensdatenbank einem Modell zuordnen oder sie im Chat mit # referenzieren, sucht Open WebUI die zur Frage passenden Abschnitte heraus und fügt sie dem Kontext hinzu. Der Leitfaden „Lokales RAG mit Ollama ohne Programmierung“ beschreibt diese Funktionsweise auf der Oberfläche im Detail.
Das Problem zeigt sich mit der Zeit. Eine auf der Festplatte geänderte Datei ist in der Wissensbasis nicht geändert: Open WebUI behält die importierte Version. Eine aus dem Ordner gelöschte Datei bleibt abfragbar. Eine neue Datei existiert nicht, solange niemand sie importiert. Bei einem Ordner mit wenigen Dokumenten kommt man mit erneutem Importieren zurecht. Bei einem Ordner mit internen Verfahren oder Notizen, der sich jede Woche ändert, wird der manuelle Neuimport vergessen, und der Assistent zitiert selbstsicher ein aufgegebenes Verfahren.
Ein Synchronisationstool automatisiert diese Arbeit: Es vergleicht den Ordner mit dem, was bereits hochgeladen wurde, und überträgt nur die Differenz. Das nennt man inkrementelle Synchronisation. Die Kehrseite: Ein Tool, das automatisch hinzufügt und ersetzt, kann auch automatisch entfernen. Das ist der Punkt, der die meiste Aufmerksamkeit erfordert.
#Inkrementelle Synchronisierung: Quelle, Ziel, Zustand
Profitiere von unserer Erfahrung und einem geführten Lernpfad, um deinen lokalen Assistenten zu erstellen und deine KI im Alltag zu nutzen.
- Lebenslanger Online-Zugang
- PDF + Dateien
- Erstattung binnen 30 Tagen
Unabhängig vom Tool beruht eine solche Synchronisierung auf drei Elementen. Wer sie versteht, kann die Dokumentation von oikb mit den richtigen Fragen im Hinterkopf lesen.
- Die Quelle
- Der lokale (oder eingehängte) Ordner, dessen Inhalt maßgeblich ist. Alles, was sich darin im gewählten Umfang befindet, soll in der Wissensbasis landen. Genau ihn müssen Sie daher sorgfältig abgrenzen: Ein darin vergessener persönlicher Unterordner wird indexiert und für alle abfragbar, die Zugriff auf die Wissensbasis haben.
- Das Ziel
- Eine bestimmte Wissensdatenbank von Open WebUI auf einer bestimmten Instanz (URL). Eine falsche Datenbank-ID kann zwei Korpora vermischen oder, schlimmer noch, dazu führen, dass Löschungen auf die falsche Wissensdatenbank angewendet werden.
- L'authentification
- Das Tool arbeitet über die API von Open WebUI mit einem an ein Konto gebundenen Schlüssel. Es erbt die Rechte dieses Kontos: Was das Konto lesen, ändern oder löschen kann, kann auch das Tool.
- Der Zustand
- Um zu wissen, was sich geändert hat, muss das Tool festhalten, was es bereits hochgeladen hat (Inhalts-Hashes, Änderungsdaten, Zuordnung zwischen lokalen Dateien und Dateien auf Seiten von Open WebUI), oder diesen Stand durch Abfrage der Wissensdatenbank rekonstruieren. Geht dieser Zustand verloren oder ist er nicht mehr abgeglichen, kann das Tool alles erneut hochladen, Duplikate erzeugen oder fehlende Dateien falsch interpretieren.
Mit diesen Elementen ordnet jeder Durchlauf die Dateien vier Fällen zu: neu (hochzuladen), geändert (zu ersetzen), unverändert (zu ignorieren), aus der Quelle verschwunden (je nach Einstellung aus der Wissensbasis zu entfernen oder zu belassen). Bevor Sie oikb starten, suchen Sie in seiner Dokumentation die Antwort auf vier Fragen: wie es eine Änderung erkennt, wo es seinen Zustand speichert, ob es verschwundene Dateien entfernt und mit welcher Option, und ob es einen Simulationsmodus bietet, der die Aktionen anzeigt, ohne sie auszuführen.
#Das eigentliche Risiko: gespiegelte Löschungen
Eine Synchronisierung, die in der Quelle fehlende Dateien aus der Wissensdatenbank entfernt, ist nützlich: Sie sorgt dafür, dass das verworfene Verfahren verschwindet. Sie verwandelt jedoch jeden Fehler auf Seiten der Quelle in einen Verlust in der Wissensdatenbank. Einige realistische Szenarien:
- Nicht eingehängtes Laufwerk
- Der Ordner verweist auf eine Netzwerkfreigabe oder ein externes Laufwerk, das zum Zeitpunkt des Durchlaufs nicht verfügbar ist. Der Einhängepunkt ist leer: Aus Sicht des Tools sind alle Dateien verschwunden.
- Falscher Pfad
- Ein Tippfehler oder ein geändertes Arbeitsverzeichnis lässt die Quelle auf einen leeren oder anderen Ordner verweisen.
- Umstrukturierung
- Das Umbenennen oder Verschieben von Unterordnern kann als „alles löschen und dann alles neu anlegen“ gewertet werden. Das Endergebnis kann korrekt sein, aber die Wissensdatenbank wird vollständig neu indexiert, und etwaige Verweise auf die alten Dateien gehen verloren.
- Gemeinsam genutzte Wissensdatenbank
- Wenn andere Personen Dateien manuell zur selben Wissensdatenbank hinzugefügt haben, kann ein Tool mit striktem Spiegelungsverhalten diese Dateien als quellfremd einstufen und entfernen. Prüfen Sie in der Dokumentation, ob oikb nur die Dateien anfasst, die es selbst hochgeladen hat.
Daraus ergeben sich zwei Regeln. Erstens sollte eine synchronisierte Wissensdatenbank ausschließlich der Synchronisierung vorbehalten sein: keine manuellen Ergänzungen darin. Zweitens: Solange Sie das Verhalten des Tools nicht an einer Testdatenbank beobachtet haben, aktivieren Sie das Löschen nicht für die im Alltag genutzte Wissensdatenbank.
#Voraussetzungen
- Funktionsfähiges Open WebUI
- Eine aktuelle Instanz, die mit Ollama verbunden ist (standardmäßig auf http://localhost:11434), mit einem konfigurierten Embedding-Modell. Der Leitfaden „Open WebUI mit Ollama: vollständiger Leitfaden“ behandelt die Installation.
- Ein eigenes Konto
- Idealerweise ein eigens für die Synchronisierung angelegtes Benutzerkonto, das Eigentümer der Wissensdatenbank ist, statt des Administratorkontos. Der Umfang des Schlüssels beschränkt sich dann auf das, was dieses Konto benötigt.
- Zugelassene API-Schlüssel
- Je nach Version muss der Administrator API-Schlüssel in den Administratoreinstellungen aktivieren, bevor ein Benutzer unter Einstellungen > Konto einen erzeugen kann. Die genauen Bezeichnungen variieren: Richten Sie sich nach Ihrer Version.
- Ein aktuelles Backup
- Ein geprüftes Archiv des Docker-Volumes von Open WebUI. Das ist der einzige echte Weg zurück, falls die Wissensbasis versehentlich geleert wird.
- Die spezifischen Voraussetzungen für oikb
- Sprache, Version und Installationsmethode sind auf der offiziellen Seite angegeben. Nicht davon ausgehen.
#Einen Ordner mit Open WebUI synchronisieren: das Vorgehen in 5 Schritten
- 011. Die Instanz sichernStoppen Sie den Container, archivieren Sie das Volume, starten Sie neu und berechnen Sie eine Prüfsumme. Das vollständige Verfahren einschließlich Wiederherstellung finden Sie in der Anleitung „Open WebUI und Ollama nach einem Ausfall wiederherstellen“. Ein nie wiederhergestelltes Backup bleibt eine Annahme: Testen Sie es mindestens einmal auf einer Kontrollinstanz.
- 022. Den Umfang abgrenzenRichten Sie oikb nicht auf Ihren gesamten Dokumente-Ordner. Bereiten Sie einen Veröffentlichungsordner vor, der nur die für die Wissensbasis bestimmten Dateien enthält, in Formaten, aus denen Open WebUI Text extrahieren kann (Text, Markdown, Text-PDF usw.). Erfassen Sie seinen Inhalt in einer Bestandsliste: Sie ist Ihre Referenz, um später zu prüfen, was in der Wissensbasis angekommen ist.
- 033. Eine Testbasis und einen Schlüssel anlegenLegen Sie unter Arbeitsbereich > Wissen eine Wissensbasis an, zum Beispiel mit dem Namen „essai-sync“. Ihre Kennung erscheint in der Adresse der Seite der Wissensbasis. Erzeugen Sie den API-Schlüssel des Synchronisationskontos, speichern Sie ihn in einer Datei, die nur Sie lesen können, und prüfen Sie mit einem einfachen Aufruf, dass er funktioniert.
- 044. Erster Durchlauf auf der TestbasisInstallieren und starten Sie oikb gemäß der offiziellen Seite, mit der Testbasis als Ziel, ohne Löschungen und im Simulationsmodus, sofern das Tool einen anbietet. Lesen Sie die Liste der angekündigten Aktionen, bevor Sie den echten Durchlauf starten. Vergleichen Sie anschließend die Anzahl der Dateien in der Wissensbasis mit Ihrer Bestandsliste.
- 055. Grenzfälle erproben, dann umstellenAuf der Testbasis: Ändern Sie eine Datei, fügen Sie eine hinzu, löschen Sie eine und starten Sie erneut. Prüfen Sie, dass nur die geänderte Datei ersetzt wird und die gelöschte Datei so behandelt wird, wie es die Dokumentation angibt. Leeren Sie anschließend vorübergehend die Quelle (benennen Sie den Ordner um) und beobachten Sie, was das Tool vorhat: Das ist der Test für ein nicht eingehängtes Laufwerk. Erst danach richten Sie oikb auf die echte Wissensbasis.
Schritt 2 kann auf rsync zurückgreifen, um den Veröffentlichungsordner aus einem Arbeitsordner zu erstellen und dabei nur bestimmte Dateiendungen zu übernehmen. Das folgende Beispiel kopiert Markdown- und PDF-Dateien, behält die Verzeichnisstruktur bei und ignoriert alles andere. Es verwendet kein --delete: Eine aus dem Arbeitsordner entfernte Datei bleibt im Veröffentlichungsordner, bis Sie sie selbst entfernen. So bleibt vor jeder Löschung in der Wissensdatenbank eine menschliche Entscheidung erforderlich.
Für Schritt 3 lässt sich der Schlüssel testen, ohne etwas zu ändern. Die API von Open WebUI akzeptiert einen Schlüssel im Header Authorization: Bearer; der folgende Aufruf listet die für das Konto sichtbaren Modelle auf. Eine JSON-Antwort bestätigt, dass URL und Schlüssel korrekt sind; ein Fehler 401 oder 403 weist auf einen ungültigen Schlüssel oder auf API-Schlüssel hin, die vom Administrator nicht zugelassen sind.
Port 3000 entspricht dem gängigsten Docker-Befehl (-p 3000:8080); passen Sie ihn an Ihre Installation an. Wie oikb den Schlüssel einliest (Umgebungsvariable, Option, Konfigurationsdatei), ist in seiner Dokumentation beschrieben: Bevorzugen Sie eine Variable oder eine Datei gegenüber Befehlszeilenoptionen, die in der Prozessliste und im Verlauf sichtbar bleiben.
#Die Synchronisation automatisieren, ohne sich angreifbar zu machen
Sobald das Verhalten an der Testdatenbank beobachtet wurde, ist die Versuchung groß, den Durchlauf stündlich zu planen. Fügen Sie vorher einige Schutzmechanismen hinzu, die nicht vom Tool abhängen.
- Die Quelle vor jedem Durchlauf prüfen
- Ein Skript, das die Synchronisierung verweigert, wenn der Veröffentlichungsordner leer ist oder seine Dateianzahl im Vergleich zur letzten Bestandsaufnahme abrupt sinkt. Das ist der einfachste Schutz gegen ein nicht eingehängtes Laufwerk.
- Ein Protokoll führen
- Die Ausgabe jedes Durchlaufs in eine datierte Datei umleiten. Bei einer überraschenden Antwort des Assistenten zeigt das Protokoll, wann eine Datei in die Wissensdatenbank aufgenommen oder daraus entfernt wurde.
- Durchläufe in größeren Abständen ansetzen
- Für Dokumente, die sich einige Male pro Woche ändern, genügt ein täglicher Durchlauf; er verringert zudem die Indexierungslast auf dem Rechner, der die Embeddings berechnet.
- Vorher sichern, nicht nur danach
- Ein regelmäßiges Backup des Volumes, unabhängig von der Synchronisation. Leert ein Durchlauf die Wissensbasis, stellt die Wiederherstellung auch die Embeddings wieder her, ohne alles neu zu indexieren.
Dieses Skript enthält absichtlich nicht den oikb-Befehl: Übernehmen Sie ihn von der offiziellen Seite und fügen Sie ihn an der angegebenen Stelle ein. Der Schwellenwert MIN ist willkürlich gewählt; eine feinere Prüfung vergleicht die Anzahl der Dateien mit der letzten Bestandsaufnahme und verweigert einen Rückgang um mehr als einen bestimmten Anteil.
#Fehlerbehebung
- 401 oder 403 bei der API
- Schlüssel abgelaufen, widerrufen oder mit einem Leerzeichen kopiert. Prüfen Sie außerdem, ob der Administrator API-Schlüssel zulässt und ob das Konto Zugriff auf die betreffende Wissensdatenbank hat.
- Hochgeladene, aber im Chat nicht auffindbare Dateien
- Hochladen und Indexieren sind zwei Schritte. Ein gescanntes PDF ohne Textebene kann angenommen werden, ohne verwertbare Passagen zu liefern. Öffnen Sie die Datei in der Wissensbasis, um den extrahierten Text zu sehen; lassen Sie Scans vor der Veröffentlichung durch eine OCR laufen.
- Duplikate in der Wissensdatenbank
- Häufiges Zeichen für einen verlorenen Zustand oder für einen ersten Durchlauf auf einer Wissensbasis, die bereits dieselben, von Hand importierten Dateien enthielt. Beginnen Sie neu mit einer leeren Wissensbasis, die ausschließlich der Synchronisation vorbehalten ist.
- Lange Neuindexierung
- Ein Wechsel des Embedding-Modells in den Einstellungen von Open WebUI erfordert eine Neuindexierung der Dokumente. Vermeiden Sie es, diese Einstellung und die Synchronisierung gleichzeitig zu ändern: Sie wüssten sonst nicht mehr, welche der beiden Änderungen eine Abweichung verursacht hat.
- Antworten weiterhin veraltet
- Prüfen Sie in der Wissensdatenbank, ob die alte Version tatsächlich ersetzt und nicht zusätzlich daneben abgelegt wurde. Öffnen Sie eine neue Unterhaltung: Abschnitte, die in einer bestehenden Unterhaltung bereits zitiert wurden, bleiben in deren Verlauf erhalten.
#Was überprüft wurde – und was nicht
Für diesen Leitfaden wurde oikb nicht getestet: keine Installation, kein Durchlauf, keine Messung von Dauer oder Volumen. Die offizielle Dokumentationsseite wurde am 30/10/2026 bei der Vorbereitung des Themas aufgerufen und konnte am 18/11/2026 nicht erneut geprüft werden. Die Sicherungsbefehle entsprechen denen aus dem Wiederherstellungsleitfaden der Website; der Schlüsseltest verwendet den Bearer-Header und den Endpunkt /api/models der API von Open WebUI, was Sie für Ihre Version bestätigen sollten. Die Fragen an die Dokumentation (Änderungserkennung, Zustand, Löschungen, Simulation) sind allgemeine Kriterien und keine Beschreibung der Funktionsweise von oikb.
#Weiterführende Informationen
- Lokales RAG mit Ollama ohne Programmieren
- Wie die Wissensdatenbanken von Open WebUI auf der Oberfläche funktionieren und wann AnythingLLM vorzuziehen ist: https://quelllm.fr/guide/rag-local-ollama-sans-coder
- Open WebUI und Ollama nach einem Ausfall wiederherstellen
- Backup des Volumes, Wiederherstellung und Kontrollinstanz, Voraussetzung für Schritt 1: https://quelllm.fr/guide/restaurer-open-webui-ollama-sauvegarde
- Open WebUI mit Ollama: der komplette Guide
- Installation und Grundeinstellungen der Oberfläche: https://quelllm.fr/guide/open-webui-ollama-tutoriel
- Primärquelle
- Open WebUI, Ecosystem-Dokumentation, Knowledge Base Sync: https://docs.openwebui.com/ecosystem/knowledge-base-sync/ (abgerufen am 30/10/2026, am 18/11/2026 nicht erneut geprüft).
Haben Sie Feedback, einen Fehler entdeckt oder möchten Sie etwas präzisieren? Geben Sie uns Bescheid – so wird der Guide für alle besser.