[PR #1260] [CLOSED] docs: document OAUTH_AUTO_REDIRECT #1248

New issue

Closed

opened 2026-10-18 14:18:18 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-18 14:18:18 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/open-webui/docs/pull/1260
Author: @zaid-marji
Created: 5/20/2026
Status: ❌ Closed

Base: dev ← Head: docs/oauth-auto-redirect

📝 Commits (1)

0e3f050 docs: document OAUTH_AUTO_REDIRECT

📊 Changes

2 files changed (+14 additions, -0 deletions)

View changed files

📝 docs/features/authentication-access/auth/sso/index.mdx (+1 -0)
📝 docs/reference/env-configuration.mdx (+13 -0)

📄 Description

What

Documents the new OAUTH_AUTO_REDIRECT environment variable, added to Open WebUI in a companion code PR (open-webui/open-webui).

When OAUTH_AUTO_REDIRECT is enabled and exactly one OAuth provider is configured, an unauthenticated visit to /auth is redirected straight to that provider — skipping the intermediate "Continue with <provider>" button. /auth?form=true reaches the local login form.

Changes

docs/reference/env-configuration.mdx — new OAUTH_AUTO_REDIRECT entry in the OAuth section (Type / Default / Description / Persistence), plus a tip on the /auth?form=true escape hatch.
docs/features/authentication-access/auth/sso/index.mdx — new row in the OAuth Configuration Overview table.

Verification

Full npm run build (Docusaurus) passes with these changes.

Targets dev so the docs stage alongside the unreleased feature.

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/open-webui/docs/pull/1260 **Author:** [@zaid-marji](https://github.com/zaid-marji) **Created:** 5/20/2026 **Status:** ❌ Closed **Base:** `dev` ← **Head:** `docs/oauth-auto-redirect` --- ### 📝 Commits (1) - [`0e3f050`](https://github.com/open-webui/docs/commit/0e3f050c50dccc79aca143118abd868060df6154) docs: document OAUTH_AUTO_REDIRECT ### 📊 Changes **2 files changed** (+14 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `docs/features/authentication-access/auth/sso/index.mdx` (+1 -0) 📝 `docs/reference/env-configuration.mdx` (+13 -0) </details> ### 📄 Description ## What Documents the new `OAUTH_AUTO_REDIRECT` environment variable, added to Open WebUI in a companion code PR (open-webui/open-webui). When `OAUTH_AUTO_REDIRECT` is enabled and exactly one OAuth provider is configured, an unauthenticated visit to `/auth` is redirected straight to that provider — skipping the intermediate "Continue with <provider>" button. `/auth?form=true` reaches the local login form. ## Changes - `docs/reference/env-configuration.mdx` — new `OAUTH_AUTO_REDIRECT` entry in the OAuth section (Type / Default / Description / Persistence), plus a tip on the `/auth?form=true` escape hatch. - `docs/features/authentication-access/auth/sso/index.mdx` — new row in the OAuth Configuration Overview table. ## Verification Full `npm run build` (Docusaurus) passes with these changes. Targets `dev` so the docs stage alongside the unreleased feature. --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-18 14:18:18 +00:00