Air-Gapped License

Prev Next

To unlock additional features in your workspace, activate your workspace with a license for your subscribed plan. You can also apply trials on your workspace to explore these additional features.

You require a premium workspace to get an air-gapped license. If you haven’t purchased a plan for premium workspaces yet, contact the Rocket.Chat sales team for assistance in purchasing the subscriptions. Once your workspace is deployed and subscribed to a premium plan, follow the steps in this document to get an air-gapped workspace license.

Get an air-gapped workspace license

If your workspace is in an air-gapped environment where it cannot communicate with our licensing servers, you’ll need to get an air-gapped license. To obtain a license for an air-gapped workspace, you can contact Rocket.Chat Sales to provide a license for you or retrieve an offline license from your Rocket.Chat cloud console. When the license is provided to you, proceed to apply the license on your workspace.

Only the Starter plan license can be obtained through the Rocket.Chat Cloud portal. For Enterprise and Pro licenses, contact the Sales team.

Hash your workspace URL for privacy

If you cannot share your workspace URL with our Sales team for privacy and security reasons, our Sales team can generate your license token using a SHA256 hash of the URL. The hash-based address is not reversible, so Rocket.Chat won’t have access to the original URL.

To generate the hash value for your workspace URL, follow the respective steps for your OS described below.

If you are using a Linux or Mac terminal, run the following command:

  • Linux: echo -n "your-workspace-domain" | sha256sum

  • Mac: echo -n "your-workspace-domain" | shasum -a 256

You should see an output like this: 176523d046360a9180a9a3ca0af17d30e1edebc0148440e921af184166ad4c8b.

If you are using Windows, open Powershell and run the following command:

$domain = "your-workspace-domain"
$bytes = [System.Text.Encoding]::UTF8.GetBytes($domain)
$sha256 = [System.Security.Cryptography.SHA256]::Create()
$hashBytes = $sha256.ComputeHash($bytes)
$hashString = [BitConverter]::ToString($hashBytes) -replace "-", ""
$hashString.ToLower()

If you are using other OS:

  • Use an external tool to generate the hash value of the workspace URL, such as SHA256.

  • Enter your workspace domain in the input section.

  • The hash value is displayed in the output section. For example, 82671fa26911cdd7b6855ccdcbdf3392bbf1c554c9a0d5fffdb5ff7cde6e49b6.

  • Remove http:// or https:// from the workspace domain. For example, example.rocket.chat.

  • It is recommended that you run the command more than once to ensure the same hash output.

Finally, contact our Sales team with the hashed URL to provide a license token for you.

Get a Starter license from Rocket.Chat cloud

Make sure that you have completed registering your workspace and continue with the following steps:

  1. On your Rocket.Chat Cloud account, click on the workspace.

  2. Click Get License.

  3. Copy the license code provided and apply the license on your workspace.

If the workspace detects that is not airgapped it will still force you to register. The assumption is that the workspace is truly unable to communicate with the outside world.

Apply your workspace license manually

After getting your workspace license, proceed with the following steps to apply it to your workspace:

  • When the License key is provided, navigate to Administration > Settings > Premium on your workspace.

  • Update the Premium License field with the License key, confirm the status of the applied license, and click Save Changes.

You may need to refresh your workspace for the changes to reflect. If you encounter an "Invalid key" error, upgrade your workspace to version 6.5 or higher and try again.

Now that you've upgraded your workspace plan, proceed to explore the additional benefits Rocket.Chat offers on your workspace. In the next section, we'll show you the extra configurations you can make on your air-gapped workspace.