Admin Account Creation

Prev Next

As you set up your workspace, creating the first administrator account is pivotal for effective workspace management, as the administrator has the highest level of control over the workspace. After deployment, the first user to register for the workspace using the setup wizard is automatically assigned the admin role.

Alternatively, you can configure an admin user during deployment by specifying it in the configuration files. This topic walks you through this method of creating the first administrator for your workspace for the Docker deployment method.

After starting the Rocket.Chat deployment, enter the additional environment variables in the compose.yml file as shown in the following example:

   environment:
      ...
      INITIAL_USER: yes # enable the first workspace user
      ADMIN_USERNAME: admin # enter the admin's username
      ADMIN_NAME: Admin # enter the admin's name
      ADMIN_EMAIL: [email protected] # enter the admin's email ID
      ADMIN_PASS: supersecret # enter a password for the admin user

Next, restart the rocketchat service with the following command:

docker compose -f  compose.yml up -d

Now, when you access your workspace for the first time, you are prompted to log in with the credentials that you configured in the compose.yml file. After you log in, step 2 of the setup wizard is displayed. Enter the information requested in the setup wizard. Once you are done, your workspace is registered on the Cloud portal, from where you can manage your workspace.

Once your workspace is ready, you can configure it and invite users to collaborate. Refer to the following guides for details:

  • User Guides: Learn the basics of your Rocket.Chat account, the types of rooms, and how to communicate with your workspace users.

  • Workspace Administration: Administrators and owners can set and manage various configurations.

  • Marketplace: Explore the available apps to enhance your workspace.