Skip to content

Getting started: HiveMQ, Native Websockets Support and Message Log Plugin

by HiveMQ Team
2 min read

In this very short blog post we want to show you how quickly you can get a local running HiveMQ with MQTT over Websockets support and the Message Log plugin ready for action.

This is an ideal starting point for trying out MQTT locally on you computer.

So without too much words we are getting started right away:

Quickest Method in under 2 min: MacOSX + Homebrew

  • Open your terminal

brew tap hivemq/homebrew-hivemq
brew install hivemq
brew install hivemq-mqtt-message-log
vi /usr/local/Cellar/hivemq/1.4.4/libexec/conf/configuration.properties (use your favorite editor)
  • Change websockets.enabled to true

  • Change websockets.port to 8000

Otherwise (longer than 2min)

  • Download the current version from here

  • Download the Message Log Plugin from here

  • Unzip HiveMQ

  • Unzip the Message Log plugin

  • Copy the plugin jar into the HiveMQ plugins folder

  • Open conf/configurations.properties with your favorite editor

  • Change websockets.enabled to true

  • Change websockets.port to 8000

Windows

  • Double click run.bat in the bin folder

Linux/MacOSX

  • Open a terminal and go into the HiveMQ folder

chmod +x bin/run.sh
./bin/run.sh

Check if everything is running

  • Open our MQTT client in the browser

  • Change host to localhost (make sure broker and browser are on the same machine)

  • Click Connect

  • HiveMQ should recognize the connect

Done!!

HiveMQ Team

Team HiveMQ brings together deep expertise in MQTT, Industrial AI, IoT data streaming, UNS, and Industrial IoT protocols. Follow us for practical deployment guidance, best practices for building a secure, reliable data backbone, and insights into how we are shaping the future of connected industries.

Our mission is to transform industrial data into real-time intelligence, actionable insights, and measurable business outcomes.

Have questions or need support? Contact us. Our experts are ready to help.

Related content:

HiveMQ logo
Review HiveMQ on G2