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

Written by The HiveMQ Team

Category: MQTT

Published: February 22, 2014

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

. . . and of cource we have a video to prove it ;)

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-Demo-Client-connected
  • HiveMQ should recognize the connect



About The HiveMQ Team

We love writing about MQTT, IoT protocols and architecture in general. Our experts are here to help, so reach out to us if we can help!
Contact us
HiveMQ 1.5.0 released
HiveMQ 1.4.2 released