Registering your workspace connects it to Rocket.Chat Cloud. Registration is required for cloud services such as mobile push notifications, marketplace apps, and license updates. Your workspace must also be within the support window to use these services.
This guide shows you how to register a self-managed workspace after setup, how to re-register it if it becomes disconnected, and how registration works for air-gapped and cloud-hosted workspaces.
New self-managed workspaces are registered during setup, as part of the setup wizard. For details, see Complete the Setup Wizard. Use this guide if you skipped that step, or if your workspace becomes disconnected, for example after a migration or a license issue.
Register a self-managed workspace
You can register in three ways:
With your Cloud account email: The standard method for workspaces with internet access.
With a registration token: Use this method if you received a token from Rocket.Chat Sales or Support, or generated one in Rocket.Chat Cloud.
During deployment: Set the token as an environment variable.
Register with your Cloud account email
Go to Manage → Workspace. If the workspace isn't registered, the version card shows Workspace not registered.
Click Register workspace.
In the dialog, click Register workspace again.
In Cloud account email, enter the email address of your Rocket.Chat Cloud account. If you don't have a Cloud account yet, enter your email address, and a new Cloud account is created and linked to this workspace.
Accept the Terms of Service and Privacy Policy, then click Next.
The Awaiting confirmation screen shows a security code. Open the email from Rocket.Chat Cloud, check that the security code matches, and click Verify Registration in the email.
When the registration is confirmed, the dialog shows Workspace registered.
If the email doesn't arrive, click Resend on the Awaiting confirmation screen, or click change email to use a different address.
Register with a token
If your workspace is on a premium plan, don't generate a token in Rocket.Chat Cloud yourself. A self-generated token creates a new registration on a free plan (Starter or Community), and it doesn't restore your existing paid subscription. Contact Rocket.Chat Sales for a token instead.
Get a token
How you get a token depends on your plan:
Premium plans: Request a registration token from Rocket.Chat Sales.
Starter and Community plans: Generate a token in Rocket.Chat Cloud:
Sign in to your Rocket.Chat Cloud account and go to Workspaces.
Click Register self-managed.
Select Copy Token and Continue Online. The token is shown in the Continue Online with Cloud Services dialog.
To register with the token:
In your workspace, go to Manage → Workspace.
Click Register workspace.
In the dialog, click Use token.
Paste the token in the Registration token field and click Next.
When the registration succeeds, the dialog shows Connected.
Register during deployment
To register the workspace automatically when it starts, set the REG_TOKEN environment variable to your registration token:
REG_TOKEN={your token here}For more details, see Deployment Environment Variables. Registering in the workspace with a token is the recommended method, because the workspace confirms whether the registration succeeded.
Update the registration status
If your workspace still shows as not registered after you register, go to Manage → Workspace → Subscription and click Sync license update. You may also need to refresh the page.
Video walkthroughs
To re-register a Starter or Community workspace, follow this video:
To re-register a premium workspace, follow this video:
Register an air-gapped workspace
An air-gapped workspace runs without internet access and can't use cloud services. The Register workspace button isn't available in air-gapped deployments.
To register an air-gapped workspace, follow the steps in Air-gapped Workspace Registration. To enable cloud services later, contact Rocket.Chat Sales.
Cloud-hosted workspaces
You don't need to register a cloud-hosted workspace. Rocket.Chat registers it and applies your plan's license before handing it over to you. A Rocket.Chat Cloud account is also created for you when you get your first cloud-hosted workspace. For more details, see Hosting FAQ.
To compare hosting options, see Rocket.Chat Cloud Hosting Service Level Agreement. For help choosing a plan, contact Rocket.Chat Sales.
Information collected during workspace registration
When you register your workspace, Rocket.Chat collects the following details to identify, support, and manage your workspace. Rocket.Chat Cloud services require this information.
Identity and contact details
Workspace ID: A unique identifier for your workspace.
Account name: The internal name of the account or workspace.
Contact name: The primary contact person for the workspace.
Contact email: The email address used for communication and license management.
Organization details
Organization address
Organization name
Organization type: For example, business, education, or nonprofit.
Industry: The sector your organization operates in.
Size of the organization: Usually the number of employees.
Country: Used for region-specific compliance and services.
Workspace configuration
Language: The default language of the workspace.
Website: Your organization's public website, if it has one.
Site name: The name displayed in the workspace.
Workspace type: For example, Community or a premium plan.
Number of seats: The number of users included in your plan.
Deployment information
Deployment method: For example, Docker, Snap, or Podman.
Deployment platform: For example, Ubuntu, Kubernetes, or DigitalOcean.
Rocket.Chat version: Used to check compatibility with services and updates.
Next steps
If you have a premium plan, apply your license. For instructions, see Manage Subscription and License.
For answers to common questions about registration, see Workspace FAQ.