Skip to content

Description of Roles

Portainer Business come with Role-Based Access Control features that refines the access privileges available natively within Portainer. The RBAC feature allows you to create fine-grained access for users across all resources and all endpoints defined within Portainer.

Basics Understanding

  • Role is a predefined set of privileges.
  • Privileges define rights to perform actions.
  • Users are assigned roles and each role has specific privileges.
  • To assign privileges, you pair a user or team with a role and associate that pairing with an endpoint or endpoint group.
  • A single user or team can have different roles for different endpoints in the Portainer inventory.

Describing Roles

There are four types of roles:

  • Endpoint Administrator: has complete control over the resources deployed within a given endpoint, but is not able to make any changes to the infrastructure that underpins an endpoint (i.e. no host management), nor are they able to make any changes to Portainer internal settings.

  • Helpdesk: has read-only access over the resources deployed within a given endpoint but is not able to make any changes to any resource, nor open a console to a container, or make changes to a container’s volumes.

  • Standard User: has complete control over the resources that a user deploys, or if the user is a member of a team, complete control over the resources that users of that team deploy.

  • Read-Only User: has read-only access over the resources they are entitled to see (resources created by members of their team, and public resources).

  • The Administrator role sits outside of these four roles, and effectively acts as a “Global Admin”. A user assigned this role has complete control over Portainer settings, and all resources on every endpoint under Portainer control.

Notes

Contribute to these docs.