Skip to main content
Version: Latest

Adding Users to Clusters

If you want to provide a user with access and permissions to all projects, nodes, and resources within a cluster, assign the user a cluster membership.


Want to provide a user with access to a specific project within a cluster? See Adding Project Members instead.

There are two contexts where you can add cluster members:

  • Adding Members to a New Cluster

    You can add members to a cluster as you create it (recommended if possible).

  • Adding Members to an Existing Cluster

    You can always add members to a cluster after a cluster is provisioned.

Editing Cluster Membership

Cluster administrators can edit the membership for a cluster, controlling which Rancher users can access the cluster and what features they can use.

  1. Click ☰ > Cluster Management.

  2. Go to the cluster you want to add members to and click ⋮ > Edit Config.

  3. In the Member Roles tab, click Add Member.

  4. Search for the user or group that you want to add to the cluster.

    If external authentication is configured:

  5. Assign the user or group Cluster roles.

    What are Cluster Roles?


    For Custom Roles, you can modify the list of individual roles available for assignment.

Result: The chosen users are added to the cluster.

  • To revoke cluster membership, select the user and click Delete. This action deletes membership, not the user.
  • To modify a user's roles in the cluster, delete them from the cluster, and then re-add them with modified roles.