Register Your Workspace

All workspaces must be registered on Rocket.Chat Cloud and remain within the support window to access cloud services. The registration process varies depending on the type of workspace. This guide explains how to register different workspaces and re-register if needed. If you do not have a Rocket.Chat Cloud account, see Create Your New Cloud Account.

Register your self-managed workspace

Once you have deployed your workspace through any of the recommended deployment methods, registering your workspace is a mandatory step during the setup wizard.

However, certain conflicts may arise that require you to re-register your workspace. Re-registering your workspace can be done through either of the following methods:

  1. Register workspace via email

  2. Register workspace with token

When a workspace is no longer registered, a Register workspace button becomes available in  Administration > Workspace > Workspace, allowing you to re-register it easily.

Register your workspace via email

To register your workspace via email,

  1. Navigate to Administration > Workspace > Workspace and click Register Workspace.

  2. Click Register Workspace. This button won’t be available on air-gapped workspaces.

  3. Add your Cloud account email to link the workspace to an existing Rocket.Chat cloud account.

  4. Agree to the Terms and Privacy Policy .

  5. Click Register workspace to proceed to the last step.

  6. The email you provided will receive an email with a confirmation link. Open the email, click Verify Registration to ensure the security codes match, and complete the registration.

  7. Once verification is successful, your workspace is now registered. Click Sync to reflect the update.  You may need to refresh your workspace to see the updated registration status.

Register your workspace with a token

You can also register your workspace using a registration token from Rocket.Chat Cloud portal, Support team, or Sales team.

Obtain a registration token

Sometimes, our Sales or Operations team may generate a registration token for you. To get a token from Rocket.Chat Cloud,

  1. Login to your Rocket.Chat cloud account and navigate to Workspaces.

  2. Click the Register self-managed button. Navigate to Click Continue Online with Cloud Services and click Copy Token and Continue Online.

Register using the token

To register your workspace using the token,

  1. Go to Administration > Workspace > Workspace and click Use Token.

  2. Enter the token in the provided field and click Next to complete the process.

  3. If the registration is successful, a "Connected" message will appear, confirming the workspace is registered.  You may need to refresh your workspace to see the updated registration status.

For older workspaces below 6.5, see Registration.

Alternatively, you can use the token to register your deployed workspace by adding it as a deployment environment variable: 

REG_TOKEN={your token here}

While you can use the token as an enviroment variable, it is recommended to add the token through the workspace UI.

Register your air-gapped workspace

For air-gapped deployments, registering offline disables all cloud services. To enable online registration later, contact Rocket.Chat Sales. To learn how to register an offline workspace, visit Air-gapped Workspace Registration.

Register your cloud-hosted workspace

Cloud-hosted workspaces are hosted on Rocket.Chat's Cloud Hosting Services. You can choose from various hosting options offered by Rocket.Chat. Contact the sales team to find a suitable cloud hosting option. A cloud account is automatically created when you initiate your first workspace with us. If you’d like to explore and assess these features, you can also apply for a SaaS trial.