Skip to main content
Chariot v3.0.0

Windows

Chariot Installation via 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
  1. Open the folder and locate: install.bat
  2. 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 by running the command:
status.bat
  • Ensure port 8080 is not blocked by a firewall, as this is the default port