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 shares deep expertise in MQTT, Industrial AI, IoT data streaming, Unified Namespace (UNS), and Industrial IoT protocols. Our blogs explore real-world challenges, practical deployment guidance, and best practices for building modern, reliable, and a secure data backbone on the HiveMQ platform, along with thought leadership shaping the future of the connected world.

We’re on a mission to build the Industrial AI Platform that transforms industrial data into real-time intelligence, actionable insights, and measurable business outcomes.

Our experts are here to support your journey. Have questions? We’re happy to help. Contact us.

Related content:

HiveMQ logo
Review HiveMQ on G2