Officially out now: The TypeDB 3.0 Roadmap >>

Users

In this guide, you’ll learn how to manage users in your TypeDB cloud application.

User management features are available in TypeDB Cloud / Enterprise only.

Management tools

You can use TypeDB Console or TypeDB driver API for managing users remotely.

Assuming TypeDB Console is installed, to connect to TypeDB:

typedb console --cloud=<server-address> --username=<username> --password --tls-enabled=true

For more information on how to use TypeDB Console, see the TypeDB Console page.

For more information on user management with TypeDB driver API, see the Python, Rust, Java, Node.js API Reference pages.

Change password on first login

The First thing you need to do is to change the default admin password:

  1. Connect to a new TypeDB.
    For example, connect with TypeDB Console (see above). Use the default credentials to do so:

    • Username: admin

    • Password: password

  2. Change the password for the default admin user.
    For example, in TypeDB Console, use the following:

    user password-update

By default, all TypeDB deployments have only one account: admin. This is the administrator account with maximum privileges. Only this account can use most of the user management features, including creating new users.

In TypeDB, you must change the administrator’s password to something different from the default value. Until you change the password, you cannot perform any operations other than changing the password.

Operations

The Change own password operation is available for any user. All other user management operations are restricted to the built-in admin account only.

List all users

This action is available only for the admin account.

To list all users, in TypeDB Console CLI run:

user list

Create a user

This action is available only for the admin account.

To create a new user, in TypeDB Console CLI run:

user create <username>

Type in a password for the new user when prompted.

Delete a user

This action is available only for the admin account.

To delete a user, in TypeDB Console CLI run:

user delete <username>

Change user’s password

This action is available only for the admin account.

To change a password of a user, in TypeDB Console CLI run:

user password-set <username>

Type in a new password for the user when prompted.

Change own password

This action is available for any account.

To change the password of the current user, in TypeDB Console CLI run:

user password-update

Type in the old password, then the new password. You’ll be disconnected as a result. Reconnect with the new password.