# Open WebUI als internes ChatGPT: Einrichtung mit SSO und Rechten

> Sie betreiben Open WebUI als Container vor Ihrem Modellserver, binden die Anmeldung per OIDC oder Entra ID an und übernehmen Rollen und Gruppen aus dem Verzeichnis. Modelle und Wissensbasen stellen Sie auf privat und geben sie Gruppen frei; für Chats legen Sie Temporary Chat, Admin-Einsicht und Löschwege fest.

Kanonische URL: https://www.ruebstudio.de/de/wissen/lokale-ki/open-webui-internes-chatgpt  
Autor: Dr.-Ing. Marcus Rüb, CEO  
Veröffentlicht: 2026-11-05

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](https://www.ruebstudio.de/de/wissen/lokale-ki/llm-inferenz-server-ueberblick). Welche lokalen Chat-Oberflächen es überhaupt gibt und wann sie ChatGPT ersetzen können, vergleicht der Artikel [ChatGPT offline nutzen](https://www.ruebstudio.de/de/wissen/lokale-ki/chatgpt-offline-lokale-alternative). 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](https://github.com/open-webui/open-webui/releases/tag/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](https://docs.openwebui.com/security/chat-data-privacy-and-encryption)).

## 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](https://docs.openwebui.com/getting-started/quick-start) liegen Chats, Nutzer und Einstellungen unter `/app/backend/data`; ohne Volume sind sie nach einem Update weg.

```yaml
# 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:

```bash
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](https://docs.openwebui.com/reference/env-configuration) 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](https://docs.openwebui.com/features/authentication-access/auth/sso) 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](https://learn.microsoft.com/en-us/entra/identity-platform/optional-claims)); das Community-Tutorial zur [Entra-Gruppennamen-Synchronisation](https://docs.openwebui.com/tutorials/auth-sso/entra-group-name-sync) 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.

```bash
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.

```bash
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](https://docs.openwebui.com/features/authentication-access/auth/sso) 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](https://docs.openwebui.com/features/authentication-access/rbac/groups) 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](https://docs.openwebui.com/security/chat-data-privacy-and-encryption) und die [Rechte-Dokumentation](https://docs.openwebui.com/features/authentication-access/rbac/permissions) 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](https://www.ruebstudio.de/de/wissen/lokale-ki/lokale-ki-betrieb).

- **Sitzungen:** Ohne Redis macht ein Logout das Token nicht ungültig; es bleibt bis zum Ablauf gültig, standardmäßig vier Wochen ([Umgebungsvariablen-Referenz](https://docs.openwebui.com/reference/env-configuration)). 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](https://www.ruebstudio.de/de/souveraene-ki) 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](https://www.ruebstudio.de/de/wissen/lokale-ki/llm-inferenz-server-ueberblick).

## 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

- [Open WebUI Docs: SSO (OAuth, OIDC, Trusted Header)](https://docs.openwebui.com/features/authentication-access/auth/sso)
- [Open WebUI Docs: Groups](https://docs.openwebui.com/features/authentication-access/rbac/groups)
- [Open WebUI Docs: Permissions](https://docs.openwebui.com/features/authentication-access/rbac/permissions)
- [Open WebUI Docs: Roles](https://docs.openwebui.com/features/authentication-access/rbac/roles)
- [Open WebUI Docs: Chat Data Privacy & Encryption](https://docs.openwebui.com/security/chat-data-privacy-and-encryption)
- [Open WebUI Docs: Environment Variable Configuration](https://docs.openwebui.com/reference/env-configuration)
- [Open WebUI Docs: Quick Start](https://docs.openwebui.com/getting-started/quick-start)
- [Open WebUI Docs: Microsoft Entra ID Group Name Sync](https://docs.openwebui.com/tutorials/auth-sso/entra-group-name-sync)
- [Microsoft Learn: Configure optional claims](https://learn.microsoft.com/en-us/entra/identity-platform/optional-claims)
- [Open WebUI Release v0.13.0 (GitHub)](https://github.com/open-webui/open-webui/releases/tag/v0.13.0)
