Air-Gapped License
    • Dark
      Light
    • PDF

    Air-Gapped License

    • Dark
      Light
    • PDF

    Article summary

    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 is unable to talk to our licensing servers, you will need to get an air-gapped license.

    To obtain a license for an air-gapped workspace, you can contact Rocket.Chat support to provide a license for you or retrieve an offline license from your Rocket.Chat cloud console.

    Contact Rocket.Chat support to provide a license for your workspace

    1. Open up a query requesting a license for your air-gapped workspace from Rocket.Chat support.

    2. When requesting, you will be required to provide the following information:

      • Your workspace registration email.

      • The workspace URL.

    3. When the license is provided to you, proceed to 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.

    If you cannot share the workspace URL for privacy and security reasons, Rocket.Chat’s team can generate the license 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, follow these steps:

    • If you are using a Linux or Mac terminal:

      • Run the following command:

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

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

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

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

      • You should see an output like this: 176523d046360a9180a9a3ca0af17d30e1edebc0148440e921af184166ad4c8b.

      • Share this hash value with the Rocket.Chat support contact to get the license.

    • 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 URL in the input section. Remove http:// or https:// from the workspace URL. For example, example.rocket.chat.

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

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

      • Share the hash output with the Rocket.Chat support contact to get the license.

    Get a license from Rocket.Chat cloud

    Make sure that you have completed registering your workspace. Purchase a plan and follow these 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.

    Apply the license

    After getting your air-gapped 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.


    Was this article helpful?