User Management
In Rill Cloud, there are several levels of user management:
- Organization members and guests: a user must have an organization-level role to access anything in an organization.
- Project roles: organization members can have direct roles on a project. For example, the creator of a project automatically becomes an admin on the project.
- User group members and roles: organization members can belong to user groups. When a user group has a role on a project, the role automatically propagates to all members of the user group. By default, a system-managed group consisting of all organization members (but not guests) is added to projects with the viewer role.
For a detailed breakdown of access permissions at different levels, see the Roles and Permissions page!
We have begun releasing new features around user management via Rill Cloud. If you'd like to learn more, please feel free to reach out!
Organization Users
At the organization-level, users can have one of the following roles:
- Admins can deploy and manage projects and manage billing.
- Editors can manage non-admin members of the organization by granting and revoking access.
- Viewers can browse the projects they have been given direct access to or indirect access to through user group memberships.
- Guests are similar to viewers, but not part of the "all members" usergroup which is added to projects by default.
For a detailed list of permissions, please refer to the Roles and Permissions.
How to Add an Organization User
Admins can be invited to an organization from the users page, or via the CLI.
From Rill Cloud User page
From the organization page, you can manage users under the Users tab. Adding users from this page will add the user to the organization.

Via the CLI
rill user add
? Select role [Use arrows to move, type to filter]
> admin
editor
viewer
guest
You will then be prompted for details about the user.
If you add a user who has not yet signed up for Rill, they will receive an email inviting them to sign up and join.
How to add a user to a user group
If you have already set up a user group, instead of setting up users individually, you can add them to a user group.
rill user add --group <group name>
? Enter email <email here>
User "<email here>" added to the user group "<group name>"
Automatically add members by email domain
You can automatically add users to your organization by their email domain. During the deployment process and in the Organization settings page. This is limited to the same domain of your user email. If you want to whitelist other domains, contact us!

For example, if you whitelist yourdomain.com
, new and existing users with an email address ending on @yourdomain.com
will automatically be added to your organization.
The feature currently requires manual action by a support representative at Rill. Just reach out here and ask us to whitelist your domain.
Project Users
Access to projects are managed at the individual project level subject to some notable rules:
- By default, all organization members (but not guests) are added to new projects through a user group membership with the viewer role. You can manually remove this relationship in the project's member settings.
- If you grant a project level role to someone who is not a member of the parent organization, they will automatically be added to the organization with the guest role.
- Removing an organization member or guest automatically also removes them from all projects in the organization.
- Organization admins implicitly have admin privileges on all projects in the organization.
Project roles
Project users can have one of three roles:
- Viewers can browse the specific project, view dashboards, and setup alerts and reports
- Editors can add and remove non-admin project members
- Admins can manage the project by updating the project files, configuring environment variables, and accessing the status page
For a detailed list of permissions, please refer to the Roles and Permissions.
How to add a Project User
There are a few ways to add a project user to Rill Cloud.
- Admin invites user to the project using
Share
. - User requests access via the project URL.
https://ui.rilldata.com/<project_name>
- Administrator invites user via the CLI with
--project <project_name>
flag.
Admin invites user from Rill Cloud
From the project's splash screen, please select share and type the email[s] along with the type of permissions.

Once sent, your invited users will receive this email and will need to accept it to view the project.

User requests access via URL
Alternatively, if you provide the project URL to your users, they can request access to the group admin. Users can request access via the page below:

The admin would receive an email to allow access, and can set the permission after accepting the request via the UI.

Admin invites user via the CLI
To add a member to a project, run the following command:
rill user add --project [PROJECT NAME]
You will then be prompted for details about the user. HINT: Run rill project list
to show available projects.
If you add a user who has not yet signed up for Rill, they will receive an email inviting them to join.
Other actions
Run rill user --help
to show commands for listing members or changing access.
User Groups
Another way to manage access is via user groups. You use the Rill CLI to create user groups and add members to them. Once you have created a user group, you can assign roles to it at the organization or project level, similar to how you assign roles to individual users.
User groups are scoped to an organization. They cannot be created only for a single project. Only organization members can be added to user groups, and user groups can only be added to projects within the organization they were created.
For more information on setting up user groups, see user group permissions.
How to add a user to a Usergroup
There are two ways to add a user to a user group.
- Admin adds them via Rill Cloud (Coming soon!)
- Admin adds them via the CLI
Adds a user to a user group in Rill Cloud
Adds a user to a user group with the Rill CLI
rill user add --group <group-name>
You will then be prompted for details on the user.
If the user you are trying to add is not part of the organization yet, the CLI will prompt you to add them to the organization first then proceed to adding them to a group.
To see the current members of a group:
rill user list --group <group-name>
To find the current user group roles, with project flag if looking for specific project's role:
rill usergroup list [--project my_project_name]
Which privilege wins?
Rill uses a logical OR operand to define the winning privilege. In other words, if any direct role or indirect role through a usergroup allows a user to take an action, the action will succeed.
Logging into Rill Cloud
In order to access a deployed project and/or view a shared dashboard, users will need to first login to Rill Cloud. When you first navigate to https://ui.rilldata.com/, you will see a few different options to login, including:
- Google SSO
- Microsoft SSO
- Email (basic auth)
Rill Cloud does support SAML authentication for our enterprise customers. If this is a requirement, please get in contact with us and we can discuss appropriate next steps to help you with your setup.
If this is the first time you are accessing Rill Cloud, you will want to sign up instead.

If you are unsure which option to select, select Continue with Email
and set up basic authentication (email address / password).
Afterwards, you should receive an email verification to complete the sign up process.

You should now be authenticated with Rill Cloud and be able to sign-in directly going forward!