To access Rocket.Chat's cloud services, all workspaces must be registered on the Rocket.Chat Cloud. Registration ensures your workspace stays within the defined support window and enables access to essential services.
This guide provides step-by-step instructions on registering different types of workspaces (e.g., self-managed, air-gapped, or cloud-hosted) and how to re-register if needed.
If you don’t already have a Rocket.Chat Cloud account, follow the steps in Create Your New Cloud Account guide before proceeding.
Register your self-managed workspace
If you're using a self-managed deployment of Rocket.Chat, registration is a mandatory step in the setup wizard. This links your workspace to the Rocket.Chat Cloud and unlocks access to cloud services such as push notifications, marketplace apps, and more.
You can register your workspace using one of the following methods:
Via email – Suitable for most standard setups.
Using a token – Recommended for advanced or offline scenarios, such as when provided by our sales or support team.
If your workspace becomes unregistered due to migration, license expiration, or network issues, re-registration can be done anytime using either method.
Once unregistered, a Register Workspace button will appear under
Administration > Workspace, making re-registration accessible.
Registering via email
To register your self-managed workspace using your Rocket.Chat Cloud email:
Go to Manage
> Workspace.Click Register Workspace.
Note: This button won’t be visible for air-gapped deployments.
Enter your Rocket.Chat Cloud account email to link your workspace.
Review and accept the Terms and Privacy Policy.
Click Register Workspace again to continue.
You'll receive a confirmation email. Open it and click Verify Registration.
Once verified, your workspace will be registered.
To complete the process, go to Manage > Workspace > Subscriptions and click Sync License to update your workspace registration status.
Registering via token
Use this method if you've received a token from the Rocket.Chat Cloud portal, Sales, or Support.
How to get a token
Log in to your Rocket.Chat Cloud account and go to Workspaces.
Click the Register self-managed button.
When prompted, select Copy Token and Continue Online. The token will be displayed in the Continue Online with Cloud Services modal.
How to register with a token
In your workspace, go to Manage
> Workspace > Register workspace.Click Use Token.
Paste the token and click Next to complete the registration.
Once successful, a “Connected” message will confirm that your workspace is registered.
To complete the process, go to Manage > Workspace > Subscriptions and click Sync License to update your workspace registration status. You may also need to refresh the workspace to update the registration status.
Alternative methods
If you prefer not to register your workspace via the UI, you can also use an environment variable to register it automatically during deployment:
REG_TOKEN={your token here}Refer to Deployment Environment Variables guide to learn more.
While this method works, we recommend using the UI-based token registration whenever possible, as it provides better feedback and validation during setup.
For Starter plan and Community, you can re-register your workspace following this video:
Register your air-gapped workspace
If you're using an air-gapped deployment, your workspace will operate offline and cannot access any cloud services.
To learn more about air-gapped setups, see: Air-gapped deployments.
To register an offline workspace, follow this guide: Air-gapped Workspace Registration.
Want to enable cloud services later? Contact Rocket.Chat Sales for assistance.
Register your cloud-hosted workspace
Cloud-hosted workspaces are managed via Rocket.Chat’s Cloud Hosting Services.
Choose from our available hosting options.
Need help selecting a plan? Reach out to our Sales Team for guidance.
When you create your first cloud-hosted workspace, a Rocket.Chat Cloud account is automatically generated for you.