Chariot Installation on Windows

Summary

This guide walks through installing the Chariot MQTT Server on a Windows machine using the provided installation scripts.

Prerequisites

• A machine running Windows
• Administrator privileges on the system (required to run installation and service scripts)

Install Chariot

1. Download Chariot MQTT Server .zip file (see Downloads)
2. Transfer the downloaded .zip file to your Windows machine
3. Extract the contents into a new folder, example: C:\Chariot
4. Open the folder and locate: install.bat
5. Run the installer by either double-clicking install.bat and approving any permission prompts, OR

• Open Command Prompt as Administrator
• Navigate to the installation directory:
  • cd C:\Chariot
  • Run: install.bat

If the script does not run, you can try it again with this syntax: .\install.bat

⚠️ Installation and service scripts must be run from the directory where Chariot was extracted

---

Start the Chariot Service

After installation completes, run serviceStart.bat.

Verify Installation

Run: status.bat

Possible results:

• RUNNING → Chariot is installed and running
• INSTALLED → Installed but not running
• NOT INSTALLED → Installation failed

---

Access the Chariot Web UI

1. Open a browser and navigate to: http://<your-server-url>:8080
2. You should see the EULA page, confirming the server is running.
3. Enter the default credentials:
   • Username: admin
   • Password: password

⚠️ It is strongly recommended to change the admin password after first login.

---

🔍 Troubleshooting

Script Does Not Run

• Ensure you are running as Administrator on your machine
• Try running from Command Prompt instead of double-clicking
  • Use: .\install.bat

Cannot Access Web UI

• Confirm the service is running: status.bat
• Ensure port 8080 is not blocked by a firewall, as this is the default port