Skip to main content
Chariot v2.0.0 - v2.6.0

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: sudo systemctl stop chariot
  • or 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: 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​

Confirm the expected configuration has been restored. Verify MQTT clients can connect successfully. 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