Register Your Air-gapped Workspace

Prev Next

This guide details the process for registering your successfully deployed air-gapped workspace with Rocket.Chat Cloud using the offline method.

Step 1: Start offline registration

  1. After deploying your air-gapped workspace, go to your workspace URL to launch the Rocket.Chat setup wizard.

  2. Complete the Admin and Organization Information steps in the Rocket.Chat setup wizard.

    If you want to keep your workspace URL confidential, skip the remaining steps below and follow the guide for hashing your workspace URL and applying license via deployment environment variable.

  3. On the Registration screen (step 3 of the setup wizard), click the Register Offline button.

  4. A unique token will appear, along with instructions for using it in Rocket.Chat Cloud. Copy the unique token.

Step 2: Register the workspace on Rocket.Chat Cloud

Using a device with internet access, continue the registration process in your Rocket.Chat Cloud account.

  1. Login to your Rocket.Chat Cloud account.

  2. Navigate to Workspaces and click Register self-managed.

  3. Click the Continue Offline button.

  4. Paste the token generated from your workspace setup wizard.

  5. Click Continue. Rocket.Chat Cloud will generate another response code required to finalize the registration.

  6. Copy this generated response code and click Continue.

Step 3: Finalize registration in your workspace

  1. Return to your workspace setup wizard to complete the process.

  2. On the Register Offline screen, agree to the Terms & Privacy Policy and click Next.

  3. Paste the response code you copied from Rocket.Chat Cloud.

  4. Click Complete Registration.

Your air-gapped workspace is now registered and ready for use! You can always update your setup information in workspace administration setup wizard.

Explore the following resources to continue using your new workspace:

  • User Guides: Learn the basics of your Rocket.Chat account, the types of rooms, and how to communicate with your workspace users.

  • Workspace Administration: Administrators and owners can set and manage various configurations.

  • Marketplace: Explore the available apps to enhance your workspace.

Information collected for registered air-gapped workspaces

The following details are collected during the registration of an air-gapped workspace:

  • Site name of the workspace

  • The workspace Id

  • The site URL or address.

  • The deployment method used for the workspace

  • The deployment platform

  • The version of Rocket.Chat deployed

  • The license version

You can also Base64-decode the tokens if you’re curious about the data captured during the token exchange.

You can also watch the video below to learn how to register and apply license for an air-gapped workspace:

Continue to the next section to learn how to apply your air-gapped license to the workspace.