Zum Inhalt springen

Open WebUI als internes ChatGPT: Einrichtung mit SSO und Rechten

Viele Firmen haben inzwischen einen eigenen Modellserver, aber noch keine Oberfläche, die Mitarbeitende ohne Schulung benutzen. Open WebUI schließt diese Lücke: ein Chatfenster im Browser, das sich an Ollama, vLLM oder jede OpenAI-kompatible Schnittstelle hängt. Dieser Artikel behandelt nur die Oberflächen-Schicht: Anmeldung über das Firmenverzeichnis, Rechte pro Gruppe und den Umgang mit gespeicherten Chats.

Was bauen wir, und was steht am Ende?

Am Ende melden sich Mitarbeitende mit ihrem Firmenkonto an, sehen nur die Modelle und Wissensbasen ihrer Abteilung, und für den Chatverlauf gibt es eine bewusste Entscheidung statt der Voreinstellung. Die Anleitung nutzt Microsoft Entra ID als Beispiel; jeder andere OIDC-Anbieter funktioniert mit denselben Bausteinen.

Wie Sie den Modellserver darunter auswählen und betreiben, beschreibt der Überblick über LLM-Inferenz-Server. Welche lokalen Chat-Oberflächen es überhaupt gibt und wann sie ChatGPT ersetzen können, vergleicht der Artikel ChatGPT offline nutzen. Hier geht es dagegen um die konkrete Einrichtung von Open WebUI, also alles, was zwischen Browser und Modellserver liegt:

  • Anmeldung: Single Sign-on per OIDC, kein lokales Passwort mehr.
  • Rollen: Wer ist Admin, wer normaler Nutzer, wer wartet auf Freigabe.
  • Gruppen: Welche Abteilung welches Modell und welche Wissensbasis sieht.
  • Chatdaten: Was gespeichert wird, wer es lesen kann und wie es wieder verschwindet.

Die Konfiguration ist für einen einzelnen Server gedacht. Mehrere Instanzen hinter einem Load Balancer brauchen zusätzlich Redis und eine gemeinsame Datenbank, das sprengt den Rahmen dieser Anleitung.

Voraussetzungen

Sie brauchen einen Linux-Server mit Docker, einen erreichbaren Modellserver und Administratorrechte im Verzeichnisdienst. Getestet haben wir die Schritte gegen die Dokumentation zu Open WebUI v0.13.0, veröffentlicht am 3. November 2026. Stand der Anleitung: November 2026.

  • Ein Server mit Docker und Docker Compose, erreichbar unter einem festen Namen, zum Beispiel chat.firma.intern, mit TLS über einen Reverse Proxy.
  • Ein Modellserver, etwa Ollama oder vLLM, den der Container über das Netz erreicht.
  • In Microsoft Entra ID mindestens die Rolle, App-Registrierungen anzulegen und Gruppen einer Enterprise-Anwendung zuzuweisen.
  • Für den Produktivbetrieb eine PostgreSQL-Datenbank. Die Datenschutz-Seite von Open WebUI empfiehlt PostgreSQL mit verschlüsseltem Speicher; bei SQLite soll das Datenverzeichnis auf einem verschlüsselten Dateisystem liegen (Chat Data Privacy).

Schritt 1: Open WebUI mit fester Version starten

Starten Sie Open WebUI mit einer festen Versionsnummer statt main und mit einem benannten Volume für die Daten. Laut Quick Start liegen Chats, Nutzer und Einstellungen unter /app/backend/data; ohne Volume sind sie nach einem Update weg.

# docker-compose.yml
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:v0.13.0
    ports:
      - "127.0.0.1:3000:8080"   # nur lokal, TLS macht der Reverse Proxy
    volumes:
      - open-webui:/app/backend/data
    env_file: .env
    restart: unless-stopped
volumes:
  open-webui:

In die .env gehören zunächst nur die Grundeinstellungen:

WEBUI_URL=https://chat.firma.intern
WEBUI_SECRET_KEY=<langer-zufallswert>
OLLAMA_BASE_URL=http://modellserver.firma.intern:11434
DATABASE_URL=postgresql://openwebui:<passwort>@db.firma.intern:5432/openwebui
DEFAULT_USER_ROLE=pending

WEBUI_SECRET_KEY signiert die Sitzungen und verschlüsselt gespeicherte OAuth-Token; die SSO-Dokumentation nennt ihn ausdrücklich als Pflichtwert, sonst drohen Sitzungsprobleme. DEFAULT_USER_ROLE=pending ist laut Umgebungsvariablen-Referenz bereits die Voreinstellung: Neue Konten warten, bis ein Admin sie freigibt. Das erste Konto auf einer frischen Installation wird automatisch Admin; legen Sie es an, bevor der Dienst für andere erreichbar ist.

Schritt 2: App-Registrierung in Microsoft Entra ID anlegen

In Entra ID legen Sie eine App-Registrierung vom Typ Web an und tragen als Redirect-URI https://chat.firma.intern/oauth/microsoft/callback ein. Danach brauchen Sie drei Werte: Client-ID, Client-Secret und Tenant-ID. Open WebUI unterstützt Microsoft laut SSO-Dokumentation nur für einen einzelnen Tenant.

Damit Gruppen später lesbar ankommen, stellen Sie die Registrierung gleich passend ein:

  1. Unter Token configuration einen Groups-Claim für ID- und Access-Token hinzufügen.
  2. Im Manifest groupMembershipClaims auf ApplicationGroup setzen und beim Claim groups die Eigenschaft cloud_displayname ergänzen.
  3. Unter Enterprise applications > Users and groups die Sicherheitsgruppen zuweisen, die Open WebUI sehen soll.

Ohne diese Schritte kommen Gruppen als Objekt-IDs (GUIDs) statt als Namen an. Microsoft dokumentiert, dass cloud_displayname nur mit ApplicationGroup wirkt (Optional claims); das Community-Tutorial zur Entra-Gruppennamen-Synchronisation zeigt das Manifest im Detail. Die Zuweisung an die Enterprise-Anwendung hat einen zweiten Vorteil: Microsoft begrenzt die Zahl der Gruppen in einem JWT auf 200, verschachtelte eingeschlossen, und empfiehlt für große Organisationen genau diese Option.

Wenn Sie Admin-Rechte über das Verzeichnis steuern wollen, legen Sie zusätzlich App-Rollen an, etwa user und admin, und weisen sie zu.

Schritt 3: SSO in Open WebUI aktivieren und Passwort-Login abschalten

Ergänzen Sie die .env um die Microsoft-Werte und die Schalter für Kontoerstellung und Login-Formular. Erst wenn die Anmeldung per SSO funktioniert, schalten Sie das Passwort-Login ab, sonst sperren Sie sich selbst aus.

MICROSOFT_CLIENT_ID=<client-id>
MICROSOFT_CLIENT_SECRET=<client-secret>
MICROSOFT_CLIENT_TENANT_ID=<tenant-id>
MICROSOFT_OAUTH_SCOPE=openid email profile offline_access
ENABLE_OAUTH_SIGNUP=true
OAUTH_ALLOWED_DOMAINS=firma.de
# erst nach erfolgreichem SSO-Test:
ENABLE_LOGIN_FORM=false
ENABLE_PASSWORD_AUTH=false
  • ENABLE_OAUTH_SIGNUP steht standardmäßig auf false; ohne den Schalter entstehen beim ersten SSO-Login keine Konten.
  • offline_access sorgt dafür, dass Microsoft ein Refresh-Token liefert. Ohne ihn funktioniert der normale Chat weiter, aber Tool-Server mit OAuth und der Zugriff auf OneDrive oder SharePoint scheitern nach etwa einer Stunde.
  • ENABLE_LOGIN_FORM=false blendet das Formular aus und blockiert lokale Registrierungen, ENABLE_PASSWORD_AUTH=false sperrt Passwort-Logins auch über die API.

Für einen anderen Anbieter wie Keycloak oder Okta nutzen Sie stattdessen OAUTH_CLIENT_ID, OAUTH_CLIENT_SECRET und OPENID_PROVIDER_URL mit der Well-known-Adresse; die Redirect-URI endet dann auf /oauth/oidc/callback. Es lässt sich nur ein OIDC-Anbieter gleichzeitig konfigurieren. OAUTH_MERGE_ACCOUNTS_BY_EMAIL lassen Sie aus, solange Ihr Anbieter E-Mail-Adressen nicht verifiziert; die Dokumentation warnt ausdrücklich davor.

Ein Detail kostet sonst Zeit: Mit der Voreinstellung ENABLE_OAUTH_PERSISTENT_CONFIG=false sind die OAuth-Felder im Admin-Bereich nur lesbar. Änderungen machen Sie in der .env und starten den Container neu.

Schritt 4: Rollen und Gruppen aus dem Verzeichnis übernehmen

Mit zwei Schaltern übernimmt Open WebUI Rollen und Gruppen bei jedem Login aus dem Token. Das spart Pflege, hat aber eine harte Folge: Die Gruppenzugehörigkeit wird strikt synchronisiert, auch von Hand angelegte Mitgliedschaften verschwinden, wenn die Gruppe nicht im Token steht.

ENABLE_OAUTH_ROLE_MANAGEMENT=true
OAUTH_ROLES_CLAIM=roles
OAUTH_ALLOWED_ROLES=user,admin
OAUTH_ADMIN_ROLES=admin
ENABLE_OAUTH_GROUP_MANAGEMENT=true
OAUTH_GROUP_CLAIM=groups
ENABLE_OAUTH_GROUP_CREATION=true
OAUTH_GROUP_DEFAULT_SHARE=members

Was die SSO-Dokumentation dazu festhält:

  • Trägt der Rollen-Claim Werte, die weder in OAUTH_ALLOWED_ROLES noch in OAUTH_ADMIN_ROLES stehen, wird der Login mit 403 abgewiesen.
  • Ein fehlender oder leerer Gruppen-Claim lässt bestehende Mitgliedschaften unverändert.
  • Admins werden genauso synchronisiert wie alle anderen.
  • Änderungen im Verzeichnis greifen erst nach Ab- und Neuanmeldung.
  • OAUTH_GROUP_DEFAULT_SHARE=members sorgt dafür, dass automatisch angelegte Gruppen nur ihren Mitgliedern im Teilen-Menü angezeigt werden statt allen.

Wer statt Entra ID einen Reverse Proxy mit eigener Anmeldung nutzt, kann Gruppen auch per Header übergeben (WEBUI_AUTH_TRUSTED_GROUPS_HEADER). Dann darf aber ausschließlich der Proxy den Container erreichen, sonst kann sich jeder als beliebiger Nutzer ausgeben.

Schritt 5: Modelle und Wissensbasen per Gruppe freigeben

Rechte gibt es in Open WebUI auf zwei Ebenen: Funktionen wie Datei-Upload oder Websuche schalten Sie pro Gruppe frei, einzelne Modelle und Wissensbasen geben Sie pro Gruppe zum Lesen oder Schreiben frei. Rechte addieren sich, ein Verbot gibt es nicht.

Die Gruppen-Dokumentation beschreibt das Prinzip so: Ist ein Nutzer in mehreren Gruppen, bekommt er die Summe aller Rechte. Daraus folgt eine saubere Aufteilung:

  • Rechtegruppen wie P-Websuche oder P-Upload schalten nur Funktionen frei und sind im Teilen-Menü unsichtbar („Who can share: No one").
  • Teamgruppen wie Vertrieb oder Technik kommen aus dem Verzeichnis, tragen keine Funktionsrechte und dienen nur der Freigabe von Ressourcen.
  • Globale Voreinstellungen bleiben knapp. Schalten Sie dort eine Funktion ab, wirkt das sofort für alle, sofern keine Gruppe sie wieder einschaltet.

Für Modelle und Wissensbasen gilt: Stellen Sie sie auf Private und tragen Sie unter Access die Teamgruppen mit Read ein. Write ist laut Dokumentation eigentümergleich, inklusive Löschen und Weiterteilen; vergeben Sie es nur an die Person, die die Wissensbasis pflegt. Hat ein Modell eigene Wissensbasen angehängt, greift es nur auf diese zu und nicht auf alle, die der Nutzer sonst sehen dürfte. So bekommt der Vertrieb ein Modell mit Preislisten und Produktdatenblättern, die Technik eines mit Serviceberichten und Prüfanweisungen.

BYPASS_MODEL_ACCESS_CONTROL muss auf der Voreinstellung false bleiben; mit true sehen alle Nutzer alle Modelle. Ob die Rechte stimmen, prüfen Sie im Admin-Bereich mit Preview Access: Die Ansicht zeigt pro Nutzer oder Gruppe alle lesbaren Modelle, Wissensbasen und Tools.

Schritt 6: Chatverlauf, Admin-Einsicht und Löschfristen festlegen

Open WebUI speichert jeden Chat dauerhaft in der Datenbank, bis jemand ihn löscht. Eine eingebaute, zeitgesteuerte Löschfrist für Chats haben wir in der offiziellen Dokumentation mit Stand November 2026 nicht gefunden. Sie entscheiden deshalb bewusst, was gespeichert wird, wer es lesen kann und auf welchem Weg es wieder verschwindet.

Die Datenschutz-Seite und die Rechte-Dokumentation bieten dafür folgende Hebel:

  • Temporary Chat: Mit „Allow Temporary Chat" plus „Enforce Temporary Chat" für eine Gruppe verweigert der Server das Speichern von Chats auf allen Wegen, auch über die API. Geeignet für Gruppen, die mit Personal- oder Gesundheitsdaten arbeiten. Tools, die im Modell aktiv sind, können trotzdem eigene Daten ablegen.
  • Admin-Einsicht: ENABLE_ADMIN_CHAT_ACCESS steht standardmäßig auf true, Admins können also alle Chats öffnen. Mit false und ENABLE_ADMIN_EXPORT=false verschwinden Chats und Exporte aus der Oberfläche. Die Dokumentation stellt klar, dass ein Admin die Daten trotzdem über Datenbank, Server oder eigene Funktionen erreicht.
  • Löschen durch Nutzer: „Allow Chat Delete" ist standardmäßig an. Schalten Sie es nur ab, wenn Sie Chats bewusst aufbewahren müssen.
  • Konto löschen: Wird ein Nutzer gelöscht, gehen seine Chats mit; das gilt auch für die Löschung per SCIM beim Austritt.
  • Protokolle: AUDIT_LOG_LEVEL=METADATA protokolliert, wer wann was aufgerufen hat, ohne Chatinhalte. REQUEST_RESPONSE schreibt Inhalte ins Log und braucht eine eigene Freigabe.

Eine feste Frist wie „Chats nach 90 Tagen löschen" setzen Sie mit einem eigenen, regelmäßig laufenden Job gegen Datenbank oder API um. Testen Sie ihn an einer Kopie und denken Sie an die Backups: Was in der Datenbank gelöscht ist, liegt in älteren Sicherungen noch vor. Welche Fristen fachlich und rechtlich passen, klären Sie mit Datenschutz und Betriebsrat; dieser Artikel ist keine Rechtsberatung. Dateien in Wissensbasen werden beim Entfernen standardmäßig mit gelöscht, außer Sie setzen ENABLE_KNOWLEDGE_FILE_RETENTION=true.

Schritt 7: Anmeldung, Rechte und Löschwege testen

Testen Sie mit zwei echten Testkonten aus unterschiedlichen Gruppen, nicht mit dem Admin. Der Admin sieht durch BYPASS_ADMIN_ACCESS_CONTROL standardmäßig mehr als normale Nutzer und verfälscht jeden Rechtetest.

  1. Mit Testkonto A (Gruppe Vertrieb) anmelden: Erscheint das Konto mit Rolle user und Gruppe Vertrieb, Gruppenname lesbar statt GUID?
  2. Modellliste prüfen: Sieht A nur die Modelle, die Vertrieb freigegeben sind?
  3. Testkonto B im Verzeichnis aus einer Gruppe entfernen, ab- und wieder anmelden: Ist die Mitgliedschaft in Open WebUI weg?
  4. Ein Konto mit einer nicht erlaubten App-Rolle anmelden: Kommt der erwartete 403?
  5. In einer Gruppe mit erzwungenem Temporary Chat einen Chat führen und prüfen, dass er nach dem Neuladen nicht in der Liste steht.
  6. Testkonto löschen und in der Datenbank prüfen, dass seine Chats entfernt sind.

Betrieb und Sicherheit

Im laufenden Betrieb drehen sich die meisten Fragen um Updates, Sitzungen und den Kreis der Admins. Halten Sie die Version fest, lesen Sie vor jedem Update die Release Notes und spielen Sie neue Versionen erst auf einer Testinstanz ein. Updates, Monitoring und Zuständigkeiten für den gesamten Stack behandelt Lokale KI dauerhaft betreiben.

  • Sitzungen: Ohne Redis macht ein Logout das Token nicht ungültig; es bleibt bis zum Ablauf gültig, standardmäßig vier Wochen (Umgebungsvariablen-Referenz). Kürzen Sie JWT_EXPIRES_IN oder setzen Sie Redis ein.
  • Admins: Behandeln Sie jeden Admin so, als könne er jeden Chat lesen. Zwei bis drei Personen reichen.
  • Backups: Verschlüsseln Sie Datenbank-Sicherungen und legen Sie fest, wie lange sie aufbewahrt werden, denn sie enthalten alle Chats.
  • Modellanbieter: Hängen Sie externe Cloud-Modelle nur an Gruppen, deren Daten das erlauben. Sensible Abteilungen bekommen nur lokale Modelle.

Wann passt der Ansatz nicht? Wenn Teams strikt getrennte Vertrauensbereiche brauchen, etwa Geschäftsleitung und Belegschaft, empfiehlt die Open-WebUI-Dokumentation getrennte Instanzen mit eigener Datenbank und eigenen Betreibern statt Gruppenrechten in einer Instanz. Wie sich eine solche Plattform in eine Strategie für souveräne KI im eigenen Haus einfügt, ist eine Frage der Architektur, nicht der Oberfläche.

Nächste Schritte

Wenn Anmeldung und Rechte stehen, lohnt sich der Blick auf die Inhalte: Welche Wissensbasen braucht welche Abteilung, und wer pflegt sie? Danach kommen Werkzeuge und Agenten, die über Open WebUI mit internen Systemen sprechen.

  • Legen Sie pro Abteilung ein Modell mit System-Prompt und angehängter Wissensbasis an, statt allen das nackte Basismodell zu zeigen.
  • Schreiben Sie eine kurze Nutzungsrichtlinie: Welche Daten dürfen in welches Modell, was passiert mit Chats, wer ist Ansprechpartner.
  • Prüfen Sie die Rechte quartalsweise mit Preview Access und gleichen Sie sie mit den Gruppen im Verzeichnis ab.
  • Wenn der Modellserver unter Last kommt, finden Sie Optionen im Überblick über LLM-Inferenz-Server.

Häufige Fragen

Kann Open WebUI zwei Anmeldeanbieter gleichzeitig nutzen?

Über OPENID_PROVIDER_URL lässt sich nur ein OIDC-Anbieter konfigurieren. Die Dokumentation verweist für Microsoft und Google gleichzeitig auf einen Community-Workaround, der nicht offiziell unterstützt wird.

Warum heißen meine Gruppen in Open WebUI wie GUIDs?

Entra ID schreibt standardmäßig Objekt-IDs in den groups-Claim. Anzeigenamen kommen nur mit cloud_displayname, und das funktioniert nur, wenn groupMembershipClaims auf ApplicationGroup steht.

Können Administratoren die Chats der Mitarbeitenden lesen?

Standardmäßig ja, ENABLE_ADMIN_CHAT_ACCESS steht auf true. Auch mit false bleibt der Zugriff über Datenbank, Server oder eigene Funktionen möglich, deshalb gehört die Admin-Rolle in wenige Hände.

Löscht Open WebUI alte Chats automatisch nach einer Frist?

In der offiziellen Dokumentation haben wir mit Stand November 2026 keine eingebaute, zeitgesteuerte Löschfrist für Chats gefunden. Fristen setzen Sie über Temporary Chat, das Löschen von Konten oder einen eigenen Löschjob um.

Quellen

  1. Open WebUI Docs: SSO (OAuth, OIDC, Trusted Header) docs.openwebui.com
  2. Open WebUI Docs: Groups docs.openwebui.com
  3. Open WebUI Docs: Permissions docs.openwebui.com
  4. Open WebUI Docs: Roles docs.openwebui.com
  5. Open WebUI Docs: Chat Data Privacy & Encryption docs.openwebui.com
  6. Open WebUI Docs: Environment Variable Configuration docs.openwebui.com
  7. Open WebUI Docs: Quick Start docs.openwebui.com
  8. Open WebUI Docs: Microsoft Entra ID Group Name Sync docs.openwebui.com
  9. Microsoft Learn: Configure optional claims learn.microsoft.com
  10. Open WebUI Release v0.13.0 (GitHub) github.com