Air-Gapped Workspace Registration

Prev Next

After deploying your air-gapped workspace successfully, navigate to your workspace URL and continue with the following steps to register your workspace on Rocket.Chat Cloud:

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

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

  • Click the Register Offline button in the next step. It displays a token with some instructions to paste it in Rocket.Chat Cloud.

    Register Offline

  • Go to your Rocket.Chat Cloud account. Navigate to Workspaces and click Register self-managed.

  • Click the Continue Offline button and paste the token displayed earlier from your workspace setup wizard.

  • Click Continue. Another code is generated on Rocket.Chat Cloud to finalize your workspace registration. Copy that generated code response and click Continue.

  • Return to your Rocket.Chat workspace setup wizard. On the Register Offline screen, agree to the  Terms & Privacy Policy, then click Next.

  • Paste the response code you got from the Cloud portal.

  • Click Complete Registration.

Once you've completed these steps, your workspace will be set up and ready to use. You can access it by logging in with your admin credentials. You can always update your setup information in workspace administration setup wizard.

For workspaces that accessible through the internet, kindly visit setup wizard to set up your workspace.

Register air-gapped workspaces on versions below 6.5

To register a workspace on a version below 6.5 without internet access,

  • Navigate to Administration > Workspace > Settings > Setup Wizard > Cloud Info and enable Cloud Service Privacy Terms Agreement. Enabling it means you agree with the Terms & Privacy Policy.

  • Navigate to Administration > Workspace > Registration and click Register Offline.

  • Copy the code snippet that is displayed on the pop-up box.

  • Create an account or login into your Rocket.Chat Cloud portal.

  • Then, click on Register self-managed to register a new workspace.

  • Click Continue Offline if you are running an air-gapped workspace or your server has no internet connection.

  • Paste the code you copied earlier from Connectivity Services and click Continue.

  • You are provided with another code from the cloud portal. Copy the code and go back to your local workspace.

  • On your local workspace, paste the code you got from the cloud portal and click Finish Registration.

With that done, you have successfully registered your workspace.

Moving to the next section, we'll guide you on how to apply air-gapped license to your air-gapped workspace.