Admin Account Creation

Creating your first admin user and user group.

As you set up your workspace, creating the first administrator account is one of the most critical steps. The administrator has the highest level of control over the workspace, making this role pivotal for effective workspace management. This guide will walk you through the process of creating the first administrator for your Rocket.Chat workspace.

Rocket.Chat Setup Wizard allows you to create the first admin user of your workspace. Alternatively, you can configure an admin user during deployment by specifying it in the configuration files.

If your server has no administrators, you can create the first admin account by defining the environment variables INITIAL_USER, ADMIN_PASS, and ADMIN_EMAIL once. Open your terminal and specify these variables line by line.

export ROOT_URL=http://your-host-name.com-as-accessed-from-internet:3000/
export MONGO_URL=mongodb://localhost:27017/rocketchat
export PORT=3000
export ADMIN_USERNAME=admin
export ADMIN_PASS=supersecret
export ADMIN_EMAIL=[e-mail]
node main.js

If you are hosting your MongoDB instance, such as MongoDB Atlas, change the MONGO_URL variable to your MongoDB connection string.

When installing Rocket.Chat server with the docker compose file, you can also specify the INITIAL_USER, ADMIN_USERNAME, and ADMIN_PASSWORD directly.

    environment:
      - PORT=3000
      - ROOT_URL=http://localhost:3000
      - MONGO_URL=mongodb://mongo:27017/rocketchat
      - MONGO_OPLOG_URL=mongodb://mongo:27017/local
      - INITIAL_USER=yes
      - ADMIN_USERNAME=admin
      - ADMIN_NAME=Admin
      - ADMIN_EMAIL=[e-mail]
      - ADMIN_PASS=supersecret
      - OVERWRITE_SETTING_Show_Setup_Wizard=completed
      - REG_TOKEN=${REG_TOKEN}
#       - MAIL_URL=smtp://smtp.email