Skip to main content
Chariot v2.7 - v2.8.1

Guide for AWS/Azure Marketplace

Summary​

This guide walks through upgrading a Chariot MQTT Server deployment installed through AWS Marketplace or Azure Marketplace.

The process consists of:

  • Exporting the existing configuration
  • Deploying a new marketplace instance
  • Restoring the backup
  • Migrating SSL certificates (if applicable)
  • Verifying client connectivity

⚠️ Chariot will be unavailable during cutover to the new instance.

Prerequisites​

  • Administrative / sudo access
  • Access to the Chariot Web UI
  • New AWS Marketplace or Azure Marketplace deployment prepared

AWS / Azure Marketplace​

Step 1: Export Configuration​

  1. Open the Chariot Web UI.
  2. Navigate to: System → Backup/Restore → Export Backup
  3. Save the exported backup .zip file.

Step 2: Backup SSL Certificates (Optional)​

If SSL is configured, copy the keystore file from the existing installation: <OLD_chariot_install_folder>/security/ssl.jks

⚠️ The SSL keystore must be copied before starting the new instance for the first time.

Step 3: Deploy the New Marketplace Instance​

Deploy the latest version of:

  • Chariot MQTT Server for AWS Marketplace
  • Chariot MQTT Server for Azure Marketplace

❗ Do not terminate the existing instance yet.

Step 4: Stop the Existing Chariot Service​

For Chariot v2.4.1 and newer, run:

sudo systemctl stop chariot

For versions earlier than v2.4.1:

sudo /etc/init.d/chariot stop

Step 5: Restore SSL Certificates (Optional)​

If using SSL, copy the ssl.jks file into the new installation:

<NEW_chariot_install_folder>/security/ssl.jks

⚠️ If Chariot is started before the keystore is copied, the certificates will not be loaded automatically.

Step 6: Start the New Chariot Service​

For Chariot v2.4.1 and newer, run:

sudo systemctl start chariot

For versions earlier than v2.4.1:

sudo /etc/init.d/chariot start

Step 7: Restore Configuration​

  1. Open the Chariot Web UI on the new instance.
  2. Navigate to System → Backup/Restore → Restore from Backup
  3. Select the backup .zip file exported earlier.

Step 8: Verify the Upgrade​

  1. Confirm the expected configuration has been restored.
  2. Verify MQTT clients can connect successfully.
  3. Validate SSL connectivity if configured.

Step 9: Decommission the Old Instance​

After validation is complete:

  1. Stop the old Chariot service.
  2. Terminate/delete the previous instance.