docs
/

User roles

4 min read

Learn about Coder's user roles and the privileges they offer.

Coder allows you to assign different roles to users, and each role comes with a distinct set of privileges regarding what the user can access and which actions they can perform.

There are four roles available:

RoleDescription
Site adminGrants full access to the system. Note that there can only be one site admin per system
Site managerAllows access to all administrative functionality in addition to basic usage rights
AuditorOffers auditing functionality
MemberAllows basic usage of Coder

Site admin permissions

CreateRead (all)Read (own)ListUpdate (all)Update (own)Delete (all)Delete (own)
API keysXXXXXXXX
Audit logsX
ConfigurationXX
Dev URLsXXXX
WorkspacesXXXX
ImagesXXXX
Image tagsXXXX
MetricsXX
OAuthXX
Org membersXXXXX
OrganizationsXXXXX
RegistriesXXXX
System bannersXXXX
UsersXXXXXXX

Site manager permissions

CreateRead (all)Read (own)ListUpdate (all)Update (own)Delete (all)Delete (own)
API keysXXXX
Audit logsX
ConfigurationXX
Dev URLsXXXX
WorkspacesXXXX
ExtensionsXX
ImagesXXXX
Image tagsXXXX
MetricsXX
OAuthXX
Org membersXXXXX
OrgsXXXXX
RegistriesXXXX
System bannersXXXX
UsersXXXXXXX

Auditor permissions

CreateRead (all)Read (own)ListUpdate (all)Update (own)Delete (all)Delete (own)
API keysXXXX
Audit logsX
ConfigurationX
Dev URLsXXX
MetricsX
UsersXXX

Member permissions

CreateRead (all)Read (own)ListUpdate (all)Update (own)Delete (all)Delete (own)
API keysXXXX
ConfigurationX
Dev URLsXXXX
MetricsX
UsersXXX

Changing a user's role

By default, all new users are assigned the Member role. These users can be upgraded to Auditor or Site Manager by another user with administrative privileges.

To change a user's role, go to Manage > Users. Find the user and use the Site Role drop-down to change the assigned role.

See an opportunity to improve our docs? Make an edit.