> 🤖 This PR was modified by Coder Agents on behalf of Jake Howell. Redesigns the create user flow using the settings page layout and renames it to "New user." The form includes clearer field guidance, explicit authentication-method loading, error, and empty states, updated documentation, and aligned end-to-end selectors. | Old | New | | --- | --- | | <img width="2560" height="2516" alt="02-create-user" src="https://github.com/user-attachments/assets/c79fb42b-3b0f-47fa-b03d-801c81584dba"/> | <img width="2560" height="2748" alt="02-create-user-page" src="https://github.com/user-attachments/assets/2d2dd777-3ae9-444d-9811-082f30eb8387"/> | Depends on #28893. <details> <summary>Stack</summary> 1. #28893 - Edit user page redesign 2. #28894 - Create user page redesign (this PR) </details>
1.1 KiB
1.1 KiB
title
| title |
|---|
| Headless Authentication |
Note
Creating service accounts requires a Premium license.
Service accounts are headless user accounts that cannot use the web UI to log in to Coder. This is useful for creating accounts for automated systems, such as CI/CD pipelines or for users who only consume Coder via another client/API. Service accounts do not have passwords or associated email addresses.
You must have the User Admin role or above to create service accounts.
Create a service account
CLI
Use the --service-account flag to create a dedicated service account:
coder users create \
--username="coder-bot" \
--service-account
UI
Navigate to Deployment > Users > New user, then select Service account as the login type.
Authenticate as a service account
To make API or CLI requests on behalf of the headless user, learn how to generate API tokens on behalf of a user.
