Page History
This page covers purchasing a Chariot license and activating it on a Chariot MQTT Server with internet access. It also covers upgrading an existing license, applying license updates with reactivation, and deactivating a license before decommissioning a server.
For air-gapped deployments, see Offline licenses. For multi-instance deployments inside a closed network, see Self-Hosted Floating License Server.
| Note |
|---|
| There are no additional licensing steps for Chariot instances deployed |
The Chariot® MQTT Server Web UI allows for uploading, activating, and deactivating valid Chariot Licenses.
| Note |
|---|
| If you have deployed Chariot through AWS Marketplace or Azure Marketplace , then no additional steps are required - your license is - licenses are already installed and activated. |
This tutorial will cover the process for both online and offline activations and deactivations:
Prerequisites
- Request a valid Chariot License from Cirrus Link Support.
- Follow the Chariot® MQTT Server Installation instructions to download and install Chariot MQTT Server instance.
License Activation
The Online Activation feature allows a Chariot License to be automatically activated on a Chariot MQTT Server instance that is connected to the internet. The Chariot MQTT Server will remotely connect and activate a Chariot License if it is valid and has an activation available.
Log into the Chariot MQTT Server Web UI and from the left hand menu bar select License as shown below:
Follow the wizard selecting first the license activation method type
Purchase a New License
There are two ways to purchase a Chariot license:
- Through the Chariot UI (covered below) — self-serve via Stripe
- Single instance Node-Locked Online Licenses Only
- By contacting Cirrus Link Support
- All Licensing Models
The instructions below cover the Chariot UI flow.
In the Chariot UI, navigate to the License page.
Select I need to purchase a license from the wizard. A modal opens showing the features available for purchase:
- IoT Bridge for Snowflake — Connect Chariot to Snowflake (meter-based licensing)
- MQTT Server — Full-featured MQTT server (one-time purchase)
- MQTT Server Support — A year of support (can be purchased yearly or multiple years at once)
Select desired features and click Purchase. The page will redirect to the Stripe purchase page.
Verify that the product selection matches what was selected in Chariot.
Fill out the payment information and click Pay. If the payment was successful, the page will redirect back to Chariot.
Cirrus Link will generate the requested license and email it to the provided contact email. Be aware this can take up to 24 hours.
Activate a License Online
After receiving the license key by email, activate it on a Chariot MQTT Server.
The Chariot License page wizard offers three activation methods; Online, Offline, and Floating, which correspond to the three license deployment models.
| Info | ||
|---|---|---|
|
...
|
...
|
...
|
...
|
This section covers Online; for the other two, see Offline Licenses or Self-Hosted Floating License Server.
Log into the Chariot MQTT Server Web UI and from the left hand menu bar select License as shown below:
Follow the wizard selecting first the license activation method type (Online)
...
Select "Online" activation method
Provide the text file containing the Chariot the Chariot License Key. This can either be done by dragging and dropping, typing, or clicking Drag and drop the file, paste the key directly, or click the upload button and selecting a select the file.
Confirm you are finished with to finish the wizard.
...
Select the "Offline" method
Next select generate usage request
Enter a valid license key and click next a popup with your offline activation code will appear. This will have to be provided to Cirrus Link Support via email so that a usage license can be properly generated.
Once you receive an email from Cirrus Link Support containing your Usage License follow the wizard to finish your offline activation.
| Warning |
|---|
| Only do this ONCE as each new Activation Request will invalidate the previous one. |
...
Select "Floating" activation method in the wizard
Provide a valid floating license server URL and select the appropriate Chariot feature set
Verify entry and click finish when ready to complete license activation flow
...
A successful activation will show the license status page, showing the state of the license, activated features, and related details.
Upgrade an Existing License
Add features to an existing license — for example, adding IoT Bridge for Snowflake to an MQTT Server license, or adding additional years of support — without re-purchasing the original features.
There are two ways to upgrade a license:
- Through the Chariot UI (covered below) — self-serve via Stripe
- By contacting Cirrus Link Support — for enterprise deals, custom terms, or payment via purchase order or invoice
The instructions below cover the Chariot UI flow.
- In the Chariot UI, navigate to the License page.
- Locate the Upgrade License widget and click Upgrade License.
- Select the features to add to the existing license.
- Click Purchase. Chariot will redirect to the Stripe purchase page.
- Verify two things on the Stripe page:
- Product selection matches what was selected in Chariot
- The license key field is pre-populated with the existing Chariot License key
- Fill out the payment details and click Pay. Do not change the license key.
- If the payment was successful, the page will redirect back to Chariot.
Cirrus Link will upgrade the license and email confirmation to the contact email on file. This can take up to 24 hours. After receiving confirmation, click Reactivate on the License page (see below) to apply the new features.
Features already activated on the license will not appear in the upgrade options, with one exception: MQTT Server Support can be purchased at any time to add additional years of support.
Reactivate an Online License
If a license has been updated — feature change, expiration date change, or any other update — click Reactivate on the License page to pull the updates without restarting Chariot.
| Warning |
|---|
| This will not work with offline activated licenses. Contact Cirrus Link Support for any changes. |
Deactivate an Online License
...
A successful activation will lead you to the license status. This will show you the state of your license, activated features and other details associated with licensing
...
In order to deactivate the license online, log into the Chariot MQTT Server Web UI and from the left hand menu bar select License as shown below.
...
Once deactivation is successfully complete you will be returned back to completed, the page will show the license activation wizard
...
In order to deactivate the license offline, log into the Chariot MQTT Server Web UI and from the left hand menu bar select License. Select deactivation:
| Tip |
|---|
| This will provide a Deactivation Request code that should be provided to Cirrus Link Support along with the License ID in order to free up the previous activation for use with another Chariot MQTT Server instance. |
...
If at any point your online / floating license has a feature change, expiration date change, or any other information that requires an update. Click the reactivate button to update your license information remotely.
...
What if I forgot to deactivate?
If a Chariot server was destroyed without deactivating first and you are unable to activate the license elsewhere, contact Cirrus Link Support. Include the License ID and a brief description of what happened. Support can review the situation and, in many cases, restore the lost activation.
Related Pages
- Chariot V3 Licensing Types — overview of all licensing options
- Offline licenses — for Chariot hosts without internet access
- Self-Hosted Floating License Server — concurrent licensing in a closed network
...
Overview
Content Tools