Roles and permissions

Coolify assigns each person a role for each team they join. A person can be an Owner in one team and a Member or Admin in another.

In Coolify v4.x, Member is the read-only role for most team resources. Admin and Owner can operate resources and manage team settings. Owner adds control over who else can become or remain an Owner.

Role comparison

Team and members

PermissionOwnerAdminMember
View the team and member listYesYesYes
Change the team name and descriptionYesYesNo
Invite Members or AdminsYesYesNo
Invite OwnersYesNoNo
Change or remove Members or AdminsYesYesNo
Change or remove OwnersYesNoNo
Delete an eligible teamYesYesNo

The member-management controls apply to other people. Coolify does not show actions for changing your own role or removing yourself on the Members page.

Projects and resources

PermissionOwnerAdminMember
View projects, environments, applications, databases, and servicesYesYesYes
Create, update, or delete projects and environmentsYesYesNo
Create, update, or delete applications, databases, and servicesYesYesNo
Deploy applications and servicesYesYesNo
Start, stop, restart, or otherwise operate resourcesYesYesNo
Manage deployments, environment variables, storage, scheduled tasks, tags, webhooks, and backupsYesYesNo
Open a resource terminalYesYesNo

Member access lets a person inspect team resources without changing or deploying them. A page may still be visible to a Member while its editing and operational controls are unavailable.

Servers and destinations

PermissionOwnerAdminMember
View team servers and destinationsYesYesYes
Add, update, or remove servers and destinationsYesYesNo
Manage the proxy and server certificate authoritiesYesYesNo
View or manage server security and SentinelYesYesNo
Use the Web TerminalYesYesNo

Terminal commands run on your infrastructure. Coolify therefore restricts both the global Web Terminal and resource terminals to Owners and Admins.

Team configuration and credentials

PermissionOwnerAdminMember
View shared-variable entriesYesYesYes
Create, update, or delete shared variablesYesYesNo
View notification settingsYesYesYes
Configure notifications or send test notificationsYesYesNo
View team S3 storage, Git sources, and private-key entriesYesYesYes
Create, update, or delete S3 storage, Git sources, and private keysYesYesNo
View or manage cloud-init scripts and cloud provider tokensYesYesNo

Viewing a credential entry does not mean Coolify reveals every stored secret. Secret fields can remain concealed even when the surrounding resource is visible.

API tokens

When API access is enabled for the instance, each role can create and revoke its own tokens.

PermissionOwnerAdminMember
Create and revoke personal API tokensYesYesYes
Create a token with read permissionYesYesYes
Grant read:sensitive, write, write:sensitive, deploy, or root permissionsYesYesNo

API tokens belong to the person who creates them and are scoped to the active team. A Member can create a read-only token, but cannot grant it sensitive, write, deployment, or root permissions. See API permissions for the available token permissions.


Owner-only controls

Owner is the highest team role. Only an Owner can:

  • invite another Owner
  • promote an Admin or Member to Owner
  • change another Owner to Admin or Member
  • remove another Owner from the team

More than one person can have the Owner role. Keep at least one trusted Owner available so the team does not depend on a single account.


Instance administration

Team roles and instance administration are separate. On a self-hosted Coolify instance, only an Owner or Admin of the default team can view or update instance-wide settings and access system resources.

An Owner or Admin role in another team does not make a person an instance administrator. That role applies to that team's resources.


Choose a role

  • Choose Member when the person only needs to review team resources and their current state.
  • Choose Admin when the person should deploy and operate resources, manage servers and credentials, change team settings, and manage Members or Admins.
  • Choose Owner only when the person must also grant, change, or remove Owner access.

Use the lowest role that provides the access the person needs. You can update another person's role from Teams > Members. Follow Manage Members for the role-change rules and verification steps.

On this page