Open WebUI installieren und mit OmniProxy konfigurieren

Open WebUI ist eine selbst bereitstellbare Chatoberfläche, die auf dem eigenen Computer oder Server installiert und auch vollständig offline betrieben werden kann. Sie ist nicht an einen bestimmten Modellanbieter gebunden: Sie können sowohl Tools wie Ollama verbinden, die Modelle lokal ausführen, als auch OpenAI-kompatible Schnittstellen, also Adressen von Modelldiensten, die dasselbe Anfrageformat verwenden. Dadurch lassen sich lokale und cloudbasierte Modelle im selben Fenster auswählen.

Open WebUI eignet sich für den langfristigen Einsatz in Teams und Organisationen. Neuere Funktionen erscheinen zuerst in Computer, dem Produkt, in dem Open WebUI neue Funktionen erprobt.

Vorbereitung vor der Installation

Open WebUI kann unter macOS, Linux und Windows verwendet werden. Die Installation ist über Docker, Python oder Kubernetes möglich. Docker installiert die Anwendung und ihre Laufzeitumgebung in einem relativ isolierten Container und ist die empfohlene Methode. Wenn Docker nicht verfügbar ist, können Sie stattdessen den unten getesteten Python-Befehl verwenden. Kubernetes ist ein System zur Bereitstellung und Verwaltung von Containern; die entsprechenden Schritte finden Sie im Quick Start am Ende dieses Leitfadens.

Offiziell empfohlen

Docker

Ein einziger docker run
Im Browser Port 3000 öffnen
Daten befinden sich im Volume

Nur chatten

slim-Image

Kleinerer Download
Tag in :slim ändern
Chatfunktion bleibt verfügbar

Hier nicht weiter behandelt

Zwei weitere Wege

Manuelle Installation mit Python
Bereitstellung mit Kubernetes
Offiziellen Quick Start lesen

Installieren Sie zuerst Docker und starten Sie Open WebUI anschließend mit dem offiziell empfohlenen Befehl. Wenn Sie nur über eine Schnittstelle chatten, können Sie das Image-Tag in slim ändern.

Bereiten Sie vor dem Start Folgendes vor:

Eine installierte und funktionsfähige Docker-Umgebung.
Eine geheime Zeichenfolge, die ausschließlich Sie verwenden. Erzeugen Sie sie mit openssl rand -hex 32 und tragen Sie sie anschließend als WEBUI_SECRET_KEY ein. Bewahren Sie diesen Wert unverändert auf. Wenn er beim Neuerstellen des Containers geändert wird, werden bereits angemeldete Benutzer abgemeldet.
Eine laufende OmniProxy-Instanz sowie eine Modell-ID aus ihrer aktuellen Modellliste. Die Modell-ID ist der vollständige Name, mit dem ein bestimmtes Modell ausgewählt wird.

Installation und erster Start

Öffnen Sie ein Terminal und führen Sie den Befehl aus dem Quick Start aus. Ersetzen Sie zuerst your-secret-key durch die zuvor erzeugte geheime Zeichenfolge:

docker run -d -p 3000:8080 --add-host=host.docker.internal:host-gateway -v open-webui:/app/backend/data -e WEBUI_SECRET_KEY=your-secret-key --name open-webui --restart always ghcr.io/open-webui/open-webui:main

Die einzelnen Teile dieses Befehls haben folgende Aufgaben:

-p 3000:8080: Ermöglicht den Zugriff auf die Oberfläche über Port 3000 dieses Computers. Wenn Port 3000 bereits belegt ist, ändern Sie die Zahl auf der linken Seite.
-v open-webui:/app/backend/data: Speichert Chats, Benutzer und Einstellungen in einem Daten-Volume. Ein Daten-Volume ist ein Ort außerhalb des Containers, an dem Daten dauerhaft gespeichert werden. Sein Inhalt bleibt auch nach einer Aktualisierung des Containers erhalten. Entfernen Sie diese Option daher nicht.
--add-host=host.docker.internal:host-gateway: Ermöglicht dem Container den Zugriff auf andere Dienste, die auf diesem Computer ausgeführt werden.
--restart always: Startet den Container nach einem Neustart des Computers erneut.

Öffnen Sie nach der Ausführung des Befehls http://localhost:3000 im Browser und erstellen Sie entsprechend den Anweisungen auf der Seite das erste Konto.

Wenn Sie ausschließlich über eine Schnittstelle chatten möchten, können Sie das Image-Tag von :main in :slim ändern. slim ist ein kleineres Image, das keine lokalen Sprach- und Einbettungsmodelle im Container enthält. Die Chatoberfläche bleibt jedoch verfügbar. Wenn Sie diese lokalen Funktionen benötigen, verwenden Sie weiterhin :main.

Für eine manuelle Aktualisierung führen Sie zuerst docker rm -f open-webui und danach docker pull ghcr.io/open-webui/open-webui:main aus. Starten Sie Open WebUI anschließend erneut mit demselben docker run-Befehl. Sowohl das Daten-Volume als auch WEBUI_SECRET_KEY müssen unverändert bleiben.

Wenn Docker nicht verfügbar ist

Der Quick Start bietet auch eine Installation über Python. Am 2026-10-09 wurde Open WebUI unter macOS mit dem folgenden Befehl als Version v0.11.4 installiert und für eine Unterhaltung verwendet. Docker Desktop war auf diesem Computer zu diesem Zeitpunkt nicht installiert.

DATA_DIR=~/.open-webui uvx --python 3.11 open-webui@latest serve

Öffnen Sie nach dem Start http://localhost:8080 im Browser. Dieser Port wird bei der Python-Installation verwendet und ist nicht der Docker-Port 3000.

Beim ersten Start wird ein Einbettungsmodell heruntergeladen, was einige Minuten dauern kann. Das Einbettungsmodell wandelt Text in Daten um, die sich für Suche und Abgleich eignen. Warten Sie, bis die Anmeldeseite erscheint. Das zuerst registrierte Konto wird zum Administrator. Die Sprache der Oberfläche richtet sich nach der Systemsprache; bei diesem Test wurde die Oberfläche auf vereinfachtem Chinesisch angezeigt.

DATA_DIR muss auf ein dauerhaft gespeichertes Verzeichnis verweisen, in dem die Daten von Open WebUI abgelegt werden. Wenn die Variable nicht festgelegt ist, können die Daten in einem temporären Verzeichnis landen und nach dem Beenden verloren gehen. Wenn WEBUI_SECRET_KEY nicht festgelegt ist, schreibt das Programm die Datei .webui_secret_key in das aktuelle Verzeichnis. Starten Sie es daher aus einem Verzeichnis, das dauerhaft erhalten bleiben soll, oder legen Sie diese Variable selbst fest.

Verbindungsparameter aus OmniProxy abrufen

Kopieren Sie die folgenden drei Werte aus Ihrer eigenen OmniProxy-Instanz:

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: vollständige ID aus der aktuellen OmniProxy-Modellliste kopieren

Die URL ist die Adresse, über die Open WebUI die Schnittstelle aufruft. Sie muss mit /v1 enden. Fügen Sie danach nicht zusätzlich /chat/completions an, da Open WebUI diesen Abschnitt selbst ergänzt.

Kopieren Sie die Modell-ID vollständig aus der aktuellen OmniProxy-Liste. Wenn die ID ein Anbieterpräfix und einen Schrägstrich enthält, müssen diese ebenfalls übernommen werden. Die folgenden beiden Kurzbezeichnungen dienen nur als Referenz aus der Anbieterdokumentation vom 2026-10-09. Verwenden Sie sie nicht, wenn sie nicht in der aktuellen Liste vorhanden sind:

Claude-API-ID von Claude Sonnet 5.5: claude-sonnet-5-5
Schnittstellenname von Gemini 3.8 Flash: gemini-3.8-flash

Tragen Sie keinen Anbieterschlüssel in Open WebUI ein. Wenn das Gateway den Schlüssel nicht überprüft, kann das Feld für den API-Schlüssel leer bleiben. Erfinden Sie in diesem Fall keinen zusätzlichen Schlüssel.

Browser

Lokaler Port 3000

Chatseite öffnen
Zuerst Registrierung abschließen
Danach Einstellungen öffnen

Im Container

Open WebUI

Nicht localhost verwenden
Stattdessen den Hostnamen verwenden
URL endet mit /v1

Derselbe Computer

OmniProxy

Schlüssel bleibt im Gateway
Die Gateway-Modellliste ist maßgeblich
Danach das Aufrufprotokoll prüfen

Wenn Open WebUI in Docker und OmniProxy auf dem Host ausgeführt wird, darf die Adresse nicht auf localhost innerhalb des Containers verweisen.

Wenn der Modelldienst auf dem Host und Open WebUI in einem Docker-Container ausgeführt wird, ersetzen Sie localhost in der URL durch host.docker.internal. Der Host ist der Computer, auf dem Docker direkt ausgeführt wird. Wenn OmniProxy nur auf diesem Computer lauscht, können Sie die URL als http://host.docker.internal:PORT/v1 angeben. Ersetzen Sie PORT durch den tatsächlich von OmniProxy verwendeten Port.

Wenn Open WebUI mit dem Python-Befehl aus dem vorherigen Abschnitt lokal ausgeführt wird und OmniProxy ebenfalls lokal läuft, verwenden Sie in der Adresse 127.0.0.1 oder localhost. Verwenden Sie in diesem Fall nicht host.docker.internal.

Konfiguration eintragen

Die vereinfachte chinesische Oberfläche von v0.11.4 am 2026-10-09 verwendete andere Bezeichnungen als Settings > Admin > Connections in der englischen Anleitung. Gehen Sie entsprechend den tatsächlich angezeigten Optionen vor:

Klappen Sie die linke Seitenleiste auf.
Klicken Sie unten auf das Benutzermenü.
Klicken Sie auf Einstellungen.
Klicken Sie unten in der Administratorgruppe auf Externe Verbindungen.
Öffnen Sie OpenAI-Schnittstellen.
Klicken Sie rechts neben OpenAI-Schnittstellenverbindungen verwalten auf +.
Tragen Sie im eingeblendeten Fenster Verbindung bearbeiten die URL bis einschließlich /v1 ein. Behalten Sie als Schnittstellentyp Chat Completions bei.
Behalten Sie unter Authentifizierungsmethode die Option Schlüssel (Bearer) bei. Bearer ist eine Methode, bei der der API-Schlüssel zur Authentifizierung in die Anfrage eingefügt wird. Wenn Sie von OmniProxy einen Schlüssel erhalten haben, tragen Sie ihn unter API-Schlüssel ein. Wenn das Gateway keinen Schlüssel überprüft, lassen Sie dieses Feld leer. Am 2026-10-09 waren sowohl die Überprüfung als auch eine Unterhaltung mit leerem Feld erfolgreich.
Klicken Sie neben der URL auf Verbindung überprüfen. Wenn OmniProxy /models bereitstellt, wird hier die Modellliste abgerufen.
Öffnen Sie Erweitert. Wenn Modell-ID leer bleibt, werden alle Modelle verwendet, die von /models unter dieser Adresse zurückgegeben werden. Tragen Sie nur bei fehlgeschlagener Überprüfung unter Modell-ID hinzufügen die vollständige ID aus der Liste ein und klicken Sie anschließend auf Hinzufügen. Fügen Sie jede ID nur einmal hinzu. Leerzeichen am Anfang und Ende werden entfernt.
Klicken Sie in diesem Fenster auf Speichern und anschließend unten rechts auf der Seite für externe Verbindungen erneut auf Speichern.

Das bloße Speichern der Konfiguration ersetzt die Überprüfung nicht. Verbindung überprüfen fragt /models beim anderen Dienst ab, also die Schnittstelle zum Auflisten der verfügbaren Modelle. Einige Dienste stellen diese Schnittstelle nicht bereit. In diesem Fall kann die Überprüfung einen Fehler melden, obwohl Chats weiterhin funktionieren können. Fügen Sie dann die Modell-ID manuell hinzu.

Eine echte Aufgabe überprüfen

Kehren Sie zur Chatseite zurück, öffnen Sie das Modellmenü neben dem Eingabefeld und wählen Sie die vollständige ID aus der OmniProxy-Liste aus. Senden Sie einen sehr kurzen Satz, etwa mit der Aufforderung, nur mit einem Wort zu antworten. Im Chatfeld muss tatsächlich eine Antwort erscheinen.

Am 2026-10-09 wurde diese Unterhaltung mit der über Python installierten Version v0.11.4 durchgeführt. Docker bleibt die empfohlene Methode, der Test wurde dieses Mal jedoch nicht zusätzlich in Docker wiederholt.

Öffnen Sie anschließend die Aufrufprotokolle von OmniProxy und prüfen Sie die Quelle sowie die Modell-ID dieser Anfrage. Nur eine erfolgreiche Speicherung oder die Anzeige des Modells im Menü reicht noch nicht aus.

Benutzeroberfläche

Modell ist auswählbar

Connections wurde gespeichert
Modell erscheint in der Liste
Eine kurze Frage senden

Antwort

Antwort erscheint im Chatfeld

Keine leere Nachricht
Kein Verbindungsfehler
Mit einem anderen Modell erneut versuchen

Protokoll

Im Gateway sichtbar

Quelle ist diese Verbindung
Modell-ID stimmt überein
Kein Schlüssel ist auf der Seite gelandet

Die Verbindung gilt erst dann als funktionsfähig, wenn alle drei Punkte übereinstimmen.

Häufige Fehler

Im Container wurde localhost oder 127.0.0.1 verwendet: Beide Adressen verweisen auf den Container selbst und nicht auf den Host. Ändern Sie die Adresse in host.docker.internal und prüfen Sie, ob der Startbefehl --add-host=host.docker.internal:host-gateway enthält. Wenn Open WebUI nicht in einem Container ausgeführt wird, gilt das Gegenteil: Verwenden Sie dann die lokale Adresse.
Der Browser kann die Seite nicht öffnen: Prüfen Sie bei Docker Port 3000 und bei Python Port 8080. Beim ersten Start müssen Sie warten, bis das Einbettungsmodell vollständig heruntergeladen wurde. Mit docker ps können Sie prüfen, ob der Container ausgeführt wird. Wenn Port 3000 belegt ist, ändern Sie den Port auf der linken Seite von -p.
Die ID im Modellmenü ist länger als die Kurzbezeichnung des Anbieters: Verwenden Sie die vollständige ID aus dem Menü einschließlich aller Schrägstriche.
Nach einer Aktualisierung wurden alle Benutzer abgemeldet: WEBUI_SECRET_KEY hat sich geändert. Starten Sie Open WebUI erneut mit der ursprünglich erzeugten geheimen Zeichenfolge.
Verbindung überprüfen schlägt fehl: Fügen Sie zuerst unter Erweitert die Modell-ID manuell hinzu und testen Sie sie anschließend mit einer echten kurzen Chatnachricht. Einige Dienste stellen /models nicht bereit. Auch wenn die Überprüfung einen Fehler meldet, können Chats weiterhin funktionieren.
Das Modell ist nicht vorhanden: Kopieren Sie die ID erneut aus der aktuellen OmniProxy-Liste und verwenden Sie keine veraltete Bezeichnung weiter.

Offizielle Referenzen

Den Installationsbefehl finden Sie im Open WebUI Quick Start. Die Verbindungsschritte finden Sie in der Anleitung für OpenAI-kompatible Verbindungen. Die als Beispiele verwendeten Modell-IDs finden Sie in der Claude-Modellübersicht und in der Gemini-Modellliste.

Ersetze jeden Platzhalter durch Werte aus deiner OmniProxy-Konfiguration. Veröffentliche niemals einen echten Schlüssel.

Ein gespeichertes Ergebnis oder HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Prüfe Quelle und Modell im OmniProxy-Aufrufprotokoll.

Offizielle Quellen · Open WebUI ↗