Skip to content

docs(docs/admin/users): document login_type=none deprecation and password conversion - #27292

Closed
jakehwll wants to merge 1 commit into
jakehwll/DEVEX-226-grandfather-legacy-login-type-nonefrom
jakehwll/DEVEX-226-service-accounts-docs
Closed

docs(docs/admin/users): document login_type=none deprecation and password conversion#27292
jakehwll wants to merge 1 commit into
jakehwll/DEVEX-226-grandfather-legacy-login-type-nonefrom
jakehwll/DEVEX-226-service-accounts-docs

Conversation

@jakehwll

@jakehwll jakehwll commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

🤖 This PR was written by Coder Agents on behalf of Jake Howell.

Docs follow-up for #26851 (DEVEX-226). Stacked on that branch so the diff is docs-only; rebase onto main once #26851 lands.

What this does

Updates docs/admin/users/headless-auth.md to document the deprecation of login_type=none and the conversion of existing accounts:

  • Creation is rejected. Documents that coder users create --login-type none (and the deprecated --disable-login) now error unless --service-account is passed, and that POST /users returns 400 for login_type: "none" without a service account. Uses the exact error strings from cli/usercreate.go and coderd/users.go.
  • Premium / OSS split. Notes that service accounts require Premium and points OSS deployments at regular users (password/GitHub/OIDC), linking the existing CI/CD tutorial.
  • Upgrade behavior. Documents that upgrading converts existing non-system login_type=none users to password login, preserving their email and existing API tokens (matching fix!: deprecate login_type=none, convert existing users to password login #26851). An admin must reset the password before web-UI login; token automation is unaffected. One-way conversion.

No new pages, so no manifest.json change.

Verification

@linear-code

linear-code Bot commented Jul 16, 2026

Copy link
Copy Markdown

DEVEX-226

@github-actions

Copy link
Copy Markdown
Contributor

Docs preview

📖 View docs preview for docs/admin/users/headless-auth.md

@jakehwll jakehwll changed the title docs(admin/users): document login_type=none deprecation and service-account conversion docs(docs/admin/users): document login_type=none deprecation and service-account conversion Jul 16, 2026
@jakehwll
jakehwll requested review from matifali and removed request for matifali July 16, 2026 14:35
@jakehwll jakehwll closed this Jul 16, 2026
@github-actions github-actions Bot locked and limited conversation to collaborators Jul 16, 2026
@jakehwll jakehwll changed the title docs(docs/admin/users): document login_type=none deprecation and service-account conversion docs(docs/admin/users): document login_type=none deprecation and password conversion Jul 20, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant