Install HiveMQ Software with a Local Installation

Deploy HiveMQ by downloading and extracting a ZIP archive to a machine of your choice.

To access the local installation wizard, follow the steps in Add HiveMQ Software, then select Local installation.

Steps

  1. Click Download in the wizard to download the HiveMQ ZIP archive.

  2. Install and start the broker for your operating system:

    Linux and macOS

    In your terminal, run the following command. Replace <version> with the version number in your downloaded filename (for example, 4.51.0):

    cd ~/Downloads && unzip hivemq-<version>.zip && cd hivemq-<version> && chmod 755 bin/run.sh && bin/run.sh

    Windows

    Extract the ZIP archive to your preferred installation directory. In the bin folder, double-click run.bat to start the broker.

  3. Open http://localhost:8080 in a browser.

    If HiveMQ runs on a remote machine, replace localhost with that machine’s IP address.

  4. Log in to the HiveMQ Control Center with the following default credentials:

    Username

    admin

    Password

    hivemq

    MQTT clients can connect on port 1883.

  5. Add your HiveMQ Platform license to unlock full broker capabilities. See Install a HiveMQ License.

Next Steps