Create Admin Account Using Enviroment Variable

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 who registers through the setup wizard is automatically assigned the admin role.

You can also create the initial administrator during deployment by defining it in your configuration. This section explains how to do this using Docker.

To configure an initial admin user during deployment:

1. Add the following environment variables to your compose.yml file:

    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: admin@email.com # enter the admin's email ID
         ADMIN_PASS: supersecret # enter a password for the admin user

2. Start the rocketchat service with the following command:

   docker compose -f  compose.yml up -d

   You can extend this command to include all services required for your Rocket.Chat workspace if they are not already running. See Deploy with Docker and Docker Compose for more details.

3. When you access your workspace, sign in using the credentials defined in the compose.yml file.

4. After signing in, step 2 of the setup wizard is displayed. Provide the required details to complete the setup.

5. When completed, the workspace is registered on the  Cloud portal, where you can manage it.

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.