{
  "schema_version": 2,
  "id": "operate/rs/security/access-control/create-users",
  "title": "Create users",
  "url": "https://redis.io/docs/latest/operate/rs/security/access-control/create-users/",
  "summary": "Create users and assign access control roles.",
  "tags": [
    "docs",
    "operate",
    "rs"
  ],
  "last_updated": "2026-10-01T15:48:36+01:00",
  "page_type": "content",
  "content_hash": "d0957d9c3658668c314d2563d211d9c341aa171d0f5c349cd82609bc36f9b02c",
  "sections": [
    {
      "id": "prerequisites",
      "title": "Prerequisites",
      "role": "overview",
      "text": "Before you create other users:\n\n1. Review the [access control overview](https://redis.io/docs/latest/operate/rs/security/access-control) to learn how to use role-based access control (RBAC) to manage users' cluster access and database access.\n\n1. Create roles you can assign to users. See [Create roles with cluster access only](https://redis.io/docs/latest/operate/rs/security/access-control/create-cluster-roles), [Create roles with database access only](https://redis.io/docs/latest/operate/rs/security/access-control/create-db-roles), or [Create roles with combined access](https://redis.io/docs/latest/operate/rs/security/access-control/create-combined-roles) for instructions."
    },
    {
      "id": "add-users",
      "title": "Add users",
      "role": "content",
      "text": "To add a user to the cluster:\n\n1. From the **Access Control > Users** tab in the Cluster Manager UI, select **+ Add user**.\n\n    ![The list of existing users on the Access Control > Users screen.](https://redis.io/docs/latest/images/rs/screenshots/access-control/7-22-updates/users-screen.png)\n\n1. Enter the name, email, and password of the new user.\n\n    > [!NOTE]\n    > - Usernames must contain ASCII characters only.\n    >\n    > - To use [single sign-on (SSO)](https://redis.io/docs/latest/operate/rs/security/access-control/saml-sso), users must have email addresses.\n    >     \n\n    ![Create user panel with fields for username, email, password, and alerts.](https://redis.io/docs/latest/images/rs/screenshots/access-control/7-22-updates/create-user-panel.png)\n\n1. Select the **Alerts** the user should receive by email:\n\n    - **Receive alerts for databases** - The alerts that are enabled for the selected databases will be sent to the user. Choose **All databases** or **Customize** to select the individual databases to send alerts for.\n    \n    - **Receive cluster alerts** - The alerts that are enabled for the cluster in **Cluster > Alerts Settings** are sent to the user.\n\n1. Click **Add permissions**.\n\n1. Assign a **Role** to the user to grant permissions for cluster management and data access.\n\n    ![Add role to new user.](https://redis.io/docs/latest/images/rs/screenshots/access-control/7-22-updates/create-user-role-select.png)\n\n1. Click **Save user**."
    },
    {
      "id": "assign-roles-to-users",
      "title": "Assign roles to users",
      "role": "content",
      "text": "Assign a role, associated with specific databases and access control lists (ACLs), to a user to grant database access:\n\n1. From the **Access Control > Users** tab in the Cluster Manager UI, select an existing user from the list of users.\n\n1. Click the **Edit** button.\n\n1. In the **User roles** section, click **Edit**.\n\n    ![The User roles section of the Edit user panel.](https://redis.io/docs/latest/images/rs/screenshots/access-control/7-22-updates/edit-user-roles.png)\n\n1. Select a role to assign to the user.\n\n    ![Select role for user.](https://redis.io/docs/latest/images/rs/screenshots/access-control/7-22-updates/edit-user-select-role.png)\n\n1. Click **Done** to close the **Roles** dialog.\n\n1. Click **Save**."
    },
    {
      "id": "next-steps",
      "title": "Next steps",
      "role": "content",
      "text": "Depending on the type of the user's assigned role (cluster management role or data access role), the user can now:\n\n- [Connect to a database](https://redis.io/docs/latest/operate/rs/databases/connect) associated with the role and run limited Redis commands, depending on the role's Redis ACLs.\n\n- Sign in to the Redis Software Cluster Manager UI.\n\n- Make a [REST API](https://redis.io/docs/latest/operate/rs/references/rest-api) request."
    }
  ],
  "examples": []
}