> 🤖 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>
40 lines
1.1 KiB
Markdown
40 lines
1.1 KiB
Markdown
---
|
|
title: Headless Authentication
|
|
---
|
|
|
|
> [!NOTE]
|
|
> Creating service accounts requires a [Premium license](https://coder.com/pricing).
|
|
|
|
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
|
|
|
|
<div class="tabs">
|
|
|
|
## CLI
|
|
|
|
Use the `--service-account` flag to create a dedicated service account:
|
|
|
|
```sh
|
|
coder users create \
|
|
--username="coder-bot" \
|
|
--service-account
|
|
```
|
|
|
|
## UI
|
|
|
|
Navigate to **Deployment** > **Users** > **New user**, then select **Service account** as the login type.
|
|
|
|

|
|
|
|
</div>
|
|
|
|
## 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](./sessions-tokens.md#generate-a-long-lived-api-token-on-behalf-of-another-user).
|