Open WebUI

Open WebUI bereitstellen und die Serververbindung als Administrator verwalten.

Installation und Vorbereitung

Installieren Sie Docker und folgen Sie dem Open WebUI Quick Start oder führen Sie den folgenden Befehl aus. Behalten Sie das benannte Datenvolume für Konten und Einstellungen. Öffnen Sie http://localhost:3000 und erstellen Sie das erste Administratorkonto. Erstellen Sie den Verbindungsschlüssel unter routerra.ai Keys und wählen Sie eine erlaubte ID aus der Gateway-Liste.

Verbindung konfigurieren

Öffnen Sie als Administrator Settings → Admin → Connections → Manage OpenAI API Connections → Add Connection. URL: https://routerra.ai/v1, API Key: YOUR_API_KEY. Aktivieren und speichern Sie den standardmäßigen OpenAI-kompatiblen Verbindungstyp. Modelle kommen normalerweise von /models; andernfalls tragen Sie YOUR_MODEL_ID in die Model IDs-Zulassungsliste ein. Diese Serververbindung wird nach den Zugriffsregeln Ihrer Instanz geteilt, anders als persönliche Browser-Direct-Connections.

docker run -d --name open-webui -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --restart always ghcr.io/open-webui/open-webui:main

Modell auswählen und Fehler beheben

Wählen Sie YOUR_MODEL_ID in einem neuen Chat. Fehlt es, prüfen Sie Verbindungsschalter und Zulassungsliste und speichern zum Aktualisieren. Gespeicherte Datenbankwerte können OPENAI_API_BASE_URL und OPENAI_API_KEY beim Neustart übersteuern; bearbeiten Sie die Admin-Verbindung. ENABLE_PERSISTENT_CONFIG=False erzwingt Umgebungswerte, macht Admin-Änderungen aber flüchtig. Bei Netzwerkfehlern prüfen Sie docker logs open-webui und ausgehendes HTTPS im Container.