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/ (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/ with your favorite editor

  • Change websockets.enabled to true

  • Change websockets.port to 8000


  • Double click run.bat in the bin folder


  • Open a terminal and go into the HiveMQ folder

chmod +x bin/

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


HiveMQ Team

The HiveMQ team loves writing about MQTT, Sparkplug, Industrial IoT, protocols, how to deploy our platform, and more. We focus on industries ranging from energy, to transportation and logistics, to automotive manufacturing. Our experts are here to help, contact us with any questions.

Related content:

HiveMQ logo
Review HiveMQ on G2