--- title: "Manage Workspace Registration" slug: "manage-workspace-registration" description: "Learn how to register your Rocket Chat workspace. Enable secure messaging, reliable collaboration, and open source flexibility for teams of any size." updated: 2026-06-30T15:31:35Z published: 2026-06-30T15:31:35Z canonical: "docs.rocket.chat/manage-workspace-registration" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Register Your Workspace To access Rocket.Chat's cloud services, all workspaces must be registered on the [Rocket.Chat Cloud](https://cloud.rocket.chat/login) and within the defined [support window](https://docs.rocket.chat/v1/docs/support-prerequisites). Registration links your workspace to Rocket.Chat Cloud and enables access to services such as push notifications, marketplace apps, and more. This guide covers how to register self-managed, air-gapped, and cloud-hosted workspaces, and how to re-register if needed. > [!WARNING] > You must have a Rocket.Chat Cloud account before registering. If you don't have one, follow the [Create Your New Cloud Account guide](/v1/docs/create-your-new-cloud-account) first. ## Register your self-managed workspace For [self-managed deployments](/v1/docs/deploy-rocketchat#deploy-selfmanaged-workspaces), workspace registration is a [required step in the setup wizard](/v1/docs/setup-your-workspace#3-register-your-workspace). You can also re-register at any time if your workspace becomes disconnected (for example, after a migration or license issue) using either [email](/v1/docs/register-your-workspace#registering-via-email) or [token](/v1/docs/register-your-workspace#registering-via-token). > [!WARNING] > Once your workspace is unregistered, a **Register Workspace** button will appear under **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> Workspace**, making re-registration accessible. ### Registering via email To register your self-managed workspace using your Rocket.Chat Cloud email: 1. Go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> Workspace**. 2. Click **Register Workspace**. > [!NOTE] > This button won’t be visible for air-gapped deployments. 3. Enter your Rocket.Chat Cloud account email to link your workspace. 4. Review and accept the **Terms and Privacy Policy**. 5. Click **Register Workspace** again to continue. 6. You'll receive a confirmation email. Open it and click **Verify Registration**. 7. Once verified, your workspace will be registered. 8. To complete the process, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> 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. #### Get a token How you get your token depends on your plan: - [Premium plans](/v1/docs/our-plans): Contact [Rocket.Chat Sales](https://www.rocket.chat/sales-contact) to request a registration token. - [Starter](/v1/docs/our-plans#starter-plan1) and [Community](/v1/docs/our-plans#community-workspaces1) workspaces: Generate a token directly from the Rocket.Chat Cloud portal. To generate a token from the Cloud portal: > [!WARNING] > If your workspace is on a premium plan, **do not** generate a token from Rocket.Chat Cloud. Self-generated tokens will create a new registration on a free plan (Starter/Community) and will not restore or reconnect your existing paid subscription. 1. Log in to your [Rocket.Chat Cloud account](https://cloud.rocket.chat/login) and go to **Workspaces**. 2. Click the **Register self-managed** button. 3. 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 1. In your workspace, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> Workspace**. 2. Click **Register Workspace**. 3. Click **Use Token**. 4. Paste the token and click **Next** to complete the registration. 5. Once successful, a “Connected” message will confirm that your workspace is registered. 6. To complete the process, go to **Manage** ![Screenshot 2025-12-23 130522.png](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot%202025-12-23%20130522.png) **> 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: ```bash REG_TOKEN={your token here} ``` Refer to [Deployment Environment Variables](/v1/docs/deployment-environment-variables) guide to learn more. > [!WARNING] > 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** and **Community workspaces**, you can re-register your workspace following this video: [Embedded content](https://www.youtube.com/embed/rKV1xF38CUQ?si=vrLk5qQbM0MsJgF9) For **premium workspaces**, you can re-register your workspace following this video: [Embedded content](https://www.youtube.com/embed/61KpWv_W8Jg?si=aPKvlB4QQOeMT6aT) --- ## 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 the [Air-gapped Workspace Registration guide.](https://docs.rocket.chat/v1/docs/air-gapped-workspace-registration) - Want to enable cloud services later? [Contact Rocket.Chat Sales](https://www.rocket.chat/sales-contact) 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.](https://docs.rocket.chat/docs/rocketchat-cloud-hosting-service-level-agreement-sla) - Need help selecting a [plan](/v1/docs/our-plans)? [Reach out to our Sales Team](https://www.rocket.chat/sales-contact) for guidance. - When you create your first cloud-hosted workspace, a Rocket.Chat Cloud account is automatically generated for you. After registration, your workspace is ready for configuration and user access. You can continue by [customizing your workspace](/v1/docs/white-labeling-and-customizing-workspace), setting up [permissions](/v1/docs/permissions), and [inviting users](/v1/docs/inviting-users).