Open WebUI Installation und OmniProxy-Konfiguration

Open WebUI ist eine selbst gehostete Chat-Oberfläche, die auf Ihrem eigenen Computer oder Server installiert werden kann und auch komplett offline läuft. Sie ist nicht an einen bestimmten Modellanbieter gebunden: Sie kann eine Verbindung zu Tools wie Ollama herstellen, die Modelle lokal ausführen, sowie zu OpenAI-kompatiblen Endpunkten – Adressen, die Modelldienste unter Verwendung desselben Anfrageformats bereitstellen. So können Sie im selben Fenster zwischen lokalen und Cloud-Modellen wechseln.

Sie eignet sich für den langfristigen Einsatz durch Teams und Organisationen. Funktionen, die schnellere Updates erhalten, erscheinen zuerst in Computer, dem Produkt, das Open WebUI verwendet, um neue Funktionen auszuprobieren.

Vorbereitung

Open WebUI ist unter macOS, Linux und Windows verfügbar. Sie können es mit Docker, Python oder Kubernetes installieren. Docker verpackt die Anwendung und ihre Laufzeitumgebung in einem relativ isolierten Container und ist die empfohlene Methode. Wenn Docker nicht verfügbar ist, können Sie auch den unten getesteten Python-Befehl verwenden. Kubernetes ist ein System zum Bereitstellen und Verwalten von Containern; siehe den Quick Start am Ende dieses Leitfadens für die entsprechenden Schritte.

Offiziell empfohlen

Docker

• Ein docker run Befehl
• Port 3000 im Browser öffnen
• Daten werden im Volume gespeichert

Möchte nur chatten

slim image

• Kleinere Downloadgröße
• Ändern Sie das Tag auf :slim
• Chat-Funktionalität bleibt verfügbar

Hier nicht behandelt

Zwei weitere Optionen

• Manuelle Python-Installation
• Kubernetes-Bereitstellung
• Siehe den offiziellen Quick Start

Bereiten Sie vor dem Start Folgendes vor:

• Docker installiert und läuft.
• Eine geheime Zeichenfolge, die nur von Ihnen verwendet wird. Führen Sie openssl rand -hex 32 aus, um eine zu generieren, und geben Sie sie dann als WEBUI_SECRET_KEYein. Speichern Sie diesen Wert dauerhaft. Wenn Sie ihn beim Neuerstellen des Containers ändern, werden Benutzer, die bereits angemeldet sind, abgemeldet.
• Eine laufende OmniProxy-Instanz und eine Modell-ID aus der aktuellen Modellliste. Die Modell-ID ist der vollständige Name, der zur Auswahl eines bestimmten Modells verwendet 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 das Geheimnis, das Sie gerade generiert haben:

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 folgenden Teile dieses Befehls dienen unterschiedlichen Zwecken:

• -p 3000:8080: Ermöglicht es Ihnen, die Schnittstelle über Port 3000 auf diesem Computer zu öffnen. Wenn Port 3000 bereits verwendet wird, ä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 langfristig aufbewahrt werden, sodass ihr Inhalt nach der Aktualisierung des Containers erhalten bleibt. Entfernen Sie diese Option nicht.
• --add-host=host.docker.internal:host-gateway: Ermöglicht dem Container den Zugriff auf andere Dienste, die auf diesem Computer laufen.
• --restart always: Startet den Container nach dem Neustart des Computers erneut.

Öffnen Sie nach Abschluss des Befehls http://localhost:3000 in einem Browser und folgen Sie den Anweisungen auf dem Bildschirm, um das erste Konto zu erstellen.

Wenn Sie nur über eine API chatten müssen, 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, aber die Chat-Oberfläche bleibt verfügbar. Verwenden Sie weiterhin :main wenn Sie diese lokalen Funktionen benötigen.

Für manuelle Updates führen Sie zuerst docker rm -f open-webuiaus, dann docker pull ghcr.io/open-webui/open-webui:mainund starten Sie es mit demselben docker run Befehl neu. Behalten Sie sowohl das Daten-Volume als auch WEBUI_SECRET_KEY unverändert bei.

Wenn Docker nicht verfügbar ist

Der Quick Start bietet auch eine Python-Installationsmethode. Am 09.10.2026 wurde der folgende Befehl unter macOS verwendet, um Open WebUI v0.11.4 zu installieren und eine Unterhaltung abzuschließen. Docker Desktop war zu diesem Zeitpunkt nicht auf diesem Computer installiert.

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

Öffnen Sie nach dem Start http://localhost:8080 in einem Browser. Dies ist der Port, der von der Python-Installation verwendet wird, nicht der Docker-Port 3000.

Ein Einbettungsmodell wird während des ersten Starts heruntergeladen, was mehrere Minuten dauern kann. Ein Einbettungsmodell wandelt Text in Daten um, die einfacher zu suchen und abzugleichen sind. Warten Sie, bis die Anmeldeseite erscheint, bevor Sie fortfahren. Das erste registrierte Konto wird zum Administrator. Die Schnittstellensprache folgt der Systemsprache; während dieses Tests wurde vereinfachtes Chinesisch angezeigt.

DATA_DIR muss auf ein Verzeichnis zeigen, das langfristig beibehalten wird und zum Speichern von Open WebUI-Daten verwendet wird. Wenn es nicht festgelegt ist, können die Daten in einem temporären Verzeichnis gespeichert werden und nach dem Herunterfahren verloren gehen. Wenn WEBUI_SECRET_KEY nicht festgelegt ist, schreibt das Programm .webui_secret_key in das aktuelle Verzeichnis. Starten Sie es aus einem Verzeichnis, das Sie beibehalten möchten, oder legen Sie diese Variable selbst fest.

Verbindungsdetails von OmniProxy abrufen

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

URL:      https://your-omniproxy-origin.example/v1
API Key:  <YOUR_OMNIPROXY_API_KEY>
Model ID: Copy from the current OmniProxy model list

Die URL ist die Adresse, die Open WebUI verwendet, um eine Verbindung zum Endpunkt herzustellen, und muss mit /v1enden. Fügen Sie danach kein /chat/completions hinzu; Open WebUI fügt diesen Teil automatisch an.

Kopieren Sie die vollständige Modell-ID aus der aktuellen Liste von OmniProxy. Wenn die ID ein Quellpräfix und einen Schrägstrich enthält, behalten Sie diese ebenfalls bei. Die folgenden zwei Kurznamen sind nur Referenzen aus der Anbieterdokumentation vom 09.10.2026. Verwenden Sie sie nicht, wenn sie nicht in der aktuellen Liste enthalten sind:

• Claude API-ID für Claude Sonnet 5.5: claude-sonnet-5-5
• API-Name für Gemini 3.8 Flash: gemini-3.8-flash

Geben Sie keinen Provider-Schlüssel in Open WebUI ein. Wenn das Gateway keine Schlüssel validiert, lassen Sie den API-Schlüssel leer, anstatt einen anderen Schlüssel zu erfinden.

Browser

Lokaler Port 3000

• Öffnen Sie die Chat-Seite
• Schließen Sie zuerst die Registrierung ab
• Öffnen Sie dann die Einstellungen

Innerhalb des Containers

Open WebUI

• Verwenden Sie nicht localhost
• Verwenden Sie stattdessen den Namen des Host-Computers
• Die URL endet mit /v1

Derselbe Computer

OmniProxy

• Behalten Sie den Schlüssel im Gateway
• Verwenden Sie die Modellliste des Gateways
• Überprüfen Sie dann die Anfrageprotokolle

Wenn der Modelldienst auf dem Host läuft, während Open WebUI in einem Docker-Container läuft, ersetzen Sie localhost in der URL durch host.docker.internal. Der Host ist der Computer, auf dem Docker direkt läuft. Wenn OmniProxy nur auf diesem Computer lauscht, kann die URL als http://host.docker.internal:port/v1geschrieben werden, wobei port durch den Port ersetzt wird, den OmniProxy tatsächlich verwendet.

Wenn Open WebUI lokal über den Python-Befehl im vorherigen Abschnitt läuft und OmniProxy ebenfalls lokal läuft, verwenden Sie 127.0.0.1 oder localhost in der Adresse. Verwenden Sie in diesem Fall nicht host.docker.internal in der Adresse.

Konfiguration eingeben

In der vereinfacht chinesischen Schnittstelle von v0.11.4, die am 09.10.2026 getestet wurde, unterschieden sich die Namen von Einstellungen > Admin > Verbindungen in den englischen Anweisungen. Folgen Sie den Optionen, die in der getesteten Schnittstelle angezeigt werden, übersetzt unten:

1. Erweitern Sie die linke Seitenleiste.
2. Klicken Sie auf das Benutzermenü unten.
3. Klicken Sie auf Einstellungen.
4. Klicken Sie im Administratorbereich unten auf Externe Verbindungen.
5. Öffnen Sie OpenAI API.
6. Klicken Sie auf + rechts neben OpenAI API-Verbindungen verwalten.
7. Geben Sie im Dialog Verbindung bearbeiten die URL ein, die mit /v1endet. Behalten Sie den API-Typ auf Chat Completions.
8. Behalten Sie Authentifizierungsmethode auf Schlüssel (Bearer). Bearer-Authentifizierung platziert den API-Schlüssel in der Anfrage zur Identitätsprüfung. Wenn OmniProxy Ihnen einen Schlüssel gegeben hat, geben Sie ihn unter API-Schlüssel ein. Wenn das Gateway keine Schlüssel validiert, lassen Sie dieses Feld leer. Am 09.10.2026 waren sowohl die Validierung als auch eine Unterhaltung erfolgreich, wobei das Feld leer gelassen wurde.
9. Klicken Sie neben der URL auf Verbindung überprüfen. Wenn OmniProxy /modelsbereitstellt, wird die Modellliste hier abgerufen.
10. Öffnen Sie Erweitert. Wenn Modell-ID leer gelassen wird, werden alle Modelle verwendet, die von /models an dieser Adresse zurückgegeben werden. Nur wenn die Validierung fehlschlägt, geben Sie eine vollständige ID aus der Liste unter Modell-ID hinzufügen ein und klicken Sie dann auf Hinzufügen. Fügen Sie jede ID nur einmal hinzu; führende und nachfolgende Leerzeichen werden entfernt.
11. Klicken Sie in diesem Fenster auf Speichern und dann in der unteren rechten Ecke der Seite Externe Verbindungen auf Speichern.

Das Speichern der Konfiguration allein ersetzt nicht die Validierung. Verbindung überprüfen fragt den /models Endpunkt des anderen Dienstes ab, der verfügbare Modelle auflistet. Einige Dienste stellen diesen Endpunkt nicht bereit, daher kann die Validierung einen Fehler melden, obwohl der Chat dennoch funktionieren kann. Fügen Sie in diesem Fall die Modell-ID manuell hinzu.

Mit einer echten Aufgabe verifizieren

Kehren Sie zur Chat-Seite zurück, öffnen Sie das Modellmenü neben dem Eingabefeld und wählen Sie die vollständige ID aus der OmniProxy-Liste aus. Senden Sie eine sehr kurze Nachricht, z. B. die Aufforderung, nur mit einem Wort zu antworten. Eine Antwort muss tatsächlich im Chat-Feld erscheinen.

Am 09.10.2026 wurde diese Unterhaltung mit der Python-Installation von v0.11.4 abgeschlossen. Docker bleibt die empfohlene Methode, aber der Test wurde in Docker nicht wiederholt.

Öffnen Sie als Nächstes die Anfrageprotokolle von OmniProxy und bestätigen Sie die Quelle und die Modell-ID für diese Anfrage. Nur ein erfolgreiches Speichern zu sehen oder das Modell nur im Menü zu sehen, zählt nicht als Abschluss.

Schnittstelle

Das Modell kann ausgewählt werden

• Verbindungen wurden gespeichert
• Das Modell erscheint in der Liste
• Senden Sie eine kurze Frage

Antwort

Das Chat-Feld zeigt eine Antwort

• Es ist keine leere Nachricht
• Es ist kein Verbindungsfehler
• Versuchen Sie es erneut mit einem anderen Modell

Protokolle

Sichtbar im Gateway

• Quelle ist diese Verbindung
• Modell-ID stimmt überein
• Es wurde kein Schlüssel auf der Seite eingegeben

Häufige Fehler

• localhost oder 127.0.0.1 wurde innerhalb des Containers verwendet: Diese Adressen zeigen auf den Container selbst, nicht auf den Host. Ändern Sie die Adresse in host.docker.internal und bestätigen Sie, dass der Startbefehl --add-host=host.docker.internal:host-gatewayenthält. Das Gegenteil gilt, wenn Open WebUI nicht in einem Container läuft: Verwenden Sie stattdessen eine lokale Adresse.
• Der Browser kann die Seite nicht öffnen: Überprüfen Sie bei Docker Port 3000; bei Python Port 8080. Warten Sie während des ersten Starts, bis der Download des Einbettungsmodells abgeschlossen ist. Sie können docker ps verwenden, um zu bestätigen, ob der Container läuft. Wenn Port 3000 bereits verwendet wird, ändern Sie den Port auf der linken Seite von -p.
• Die ID im Modellmenü ist länger als der Kurzname des Anbieters: Verwenden Sie die vollständige ID aus dem Menü, einschließlich aller Schrägstriche.
• Jeder wird nach einem Update abgemeldet: WEBUI_SECRET_KEY geändert. Starten Sie neu mit dem Geheimnis, das beim ersten Mal generiert wurde.
• Verbindung überprüfen schlägt fehl: Fügen Sie zuerst manuell die Modell-ID unter Erweitert hinzu und bestätigen Sie sie dann mit einem echten Ein-Satz-Chat. Einige Dienste stellen /modelsnicht bereit, daher kann der Chat funktionieren, wenn die Validierung einen Fehler meldet.
• Das Modell existiert nicht: Kopieren Sie die ID erneut aus der aktuellen Liste von OmniProxy, anstatt weiterhin einen veralteten Namen zu verwenden.

Offizielle Referenzen

Für Installationsbefehle siehe Open WebUI Quick Start. Für Verbindungsschritte siehe OpenAI-compatible connection instructions. Für die in den Beispielen verwendeten Modell-IDs siehe Claude model overview und Gemini model list.

Ersetzen Sie jeden Platzhalter mit Werten aus Ihrer eigenen OmniProxy-Konfiguration. Veröffentlichen Sie niemals einen echten Schlüssel.

Ein gespeicherter HTTP 200 allein beweist keine vollständige Agenten-Kompatibilität. Überprüfen Sie die Quelle und das Modell im Aufrufprotokoll von OmniProxy.

Offizielle Quellen · Open WebUI ↗