Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs: replace the oauth2 experiment with CODER_OAUTH2_PROVIDER_ENABLE - #29268

Draft
BobbyHo wants to merge 2 commits into
plat-492-4-startup-linesfrom
plat-492-5-docs
Draft

docs: replace the oauth2 experiment with CODER_OAUTH2_PROVIDER_ENABLE#29268
BobbyHo wants to merge 2 commits into
plat-492-4-startup-linesfrom
plat-492-5-docs

Conversation

@BobbyHo

@BobbyHo BobbyHo commented Sep 12, 2026

Copy link
Copy Markdown
Contributor

TL;DR

Last of five for PLAT-492. The docs no longer tell admins to enable the oauth2 experiment. The OAuth2 provider page, the MCP server page and the feature stages page show CODER_OAUTH2_PROVIDER_ENABLE instead.

PR What it does
#29248 Adds the flag, a public build info field, and the test default.
#29251 Gates the OAuth2 routes and dashboard navigation on the flag.
#29257 Makes the oauth2 experiment a no-op with a startup warning.
#29267 Logs the provider state and any registered apps at startup.
this Docs.

Changes
  • docs/admin/integrations/oauth2-provider.md: the title and callout drop "experimental". The Enable section shows the CLI flag, env var, YAML key and Helm coder.env forms. The troubleshooting entry becomes "OAuth2 endpoints return 404". The limitations and feedback sections drop the experimental framing.
  • docs/ai-coder/mcp-server.md: prerequisites become the flag plus CODER_EXPERIMENTS=mcp-server-http. The OAuth2 note and troubleshooting bullet name the flag.
  • docs/install/releases/feature-stages.md: one sentence in the GA section says a few GA features are off by default, naming the provider.
Release note draft

OAuth 2.1 provider is generally available and off by default. Set CODER_OAUTH2_PROVIDER_ENABLE=true to turn it on. The oauth2 experiment no longer has any effect and will be removed in a future release. Deployments that relied on CODER_EXPERIMENTS=oauth2 must set the new flag or their OAuth2 clients get 404 responses after upgrading. Setting the environment variable before upgrading is safe and avoids the gap; the old binary ignores it. Do not set the YAML key or the CLI flag before upgrading, because the old binary rejects both. On Kubernetes, set it through coder.env rather than coder.commandArgs, so pods on the old image keep starting. Existing OAuth2 applications, secrets and user authorizations are preserved and resume when the flag is set. Access tokens issued before the upgrade remain valid until they expire.

The OAuth2 provider page, the MCP server page and the feature stages
page told admins to enable the oauth2 experiment, which no longer has
any effect. They now show CODER_OAUTH2_PROVIDER_ENABLE in CLI, env,
YAML and Helm forms, and the provider page drops the experimental
framing.
@linear-code

linear-code Bot commented Sep 12, 2026

Copy link
Copy Markdown

PLAT-492

@github-actions

github-actions Bot commented Sep 12, 2026

Copy link
Copy Markdown
Contributor

Docs preview

Check off each page once it's been reviewed. If a page changes in a later push, its checkbox clears automatically so it gets a fresh look. Pages not yet wired into the docs navigation aren't listed here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant