Getting started

New to MQTT and HiveMQ?

Getting started with HiveMQ

HiveMQ is a MQTT broker. A broker is basically the server part in the MQTT communication. Beside the common broker functionality HiveMQ provides some extended functionality like building (high availability) clusters, deep integration to your application- and IT infrastructure and enhanced security.

Pre-Installation requirements

Windows, Linux and Mac OS X are supported environments. Java 11 or newer is required.

A more detailed list of requirements can be found in the HiveMQ User Guide.

Installation

  • Download the latest HiveMQ archive
  • Unpack
  • Run

Windows

Unpack: Extract the Zip-archive using your file browser into a directory of your choice

Run: Change to the folder bin and run the run.bat file by double clicking on it.

Linux/Mac OS X

Unpack:

1
unzip hivemq-<version>.zip


Run:

1
2
3
cd <hivemq_install_directory>/bin
chmod 755 run.sh
./run.sh

Verify

You should be able to connect to your IP on the default MQTT port 1883

Windows:

Start the CMD and type:

1
netstat -an|find "1883"

Linux:

1
netstat -an|grep 1883


You should see a line like the following in the output

1
tcp46      0      0  .1883                 .*                    LISTEN