Deploy a Broker

This task explains how to deploy a HiveMQ broker. You choose one of two ways to run the broker, deploy it, and verify it.

A deployed broker runs, but it does not automatically appear in the Connect tab. After you deploy the broker, you must connect the broker to the platform. See Connect a Broker or Edge with the Platform.

Choose How to Run HiveMQ

HiveMQ Cloud and HiveMQ Software are the same product. They differ in who operates the broker and how you enable functionality.

HiveMQ Cloud HiveMQ Software

Operated by

HiveMQ

You (self-managed, on-premises, or your own cloud)

Functionality

Depends on the plan you choose

All functionality is available after you license the broker

Best for

A fast start with no infrastructure to manage

Full control over where and how the broker runs

  1. In the Connect tab, select Get a broker or edge.

  2. Select HiveMQ Cloud or HiveMQ Software.

Option A: Deploy a HiveMQ Cloud cluster

HiveMQ manages and operates HiveMQ Cloud. Choose the plan that fits your needs:

  • HiveMQ Cloud Serverless and Starter plans are available as self-service. To deploy, see Add a HiveMQ Cloud Broker.

  • HiveMQ Cloud Enterprise is provisioned through the HiveMQ sales process. Contact your HiveMQ account team.

HiveMQ Cloud Serverless and Starter plans do not support Data Intelligence. To use Data Intelligence, select a different deployment type.

Option B: Deploy HiveMQ Software

HiveMQ Software is self-managed. Choose a deployment method. Each method follows the same steps: fulfil the prerequisites, get the product running, verify the broker, and (optionally) license it.

Deployment Method Guide

Docker

Run the HiveMQ container

Kubernetes

Install the HiveMQ Platform Operator and deploy

Local install

Download and run locally

AWS

Deploy on AWS

Azure

Deploy on Azure

Each method follows the same four steps:

  1. Prerequisites: What you need in place before you start.

  2. Run the product: For example, in Docker, run the container. In Kubernetes, install the HiveMQ Platform Operator with the Helm chart, then install the platform with the operator.

  3. Verify in the Control Center: Log in to the Control Center to confirm the broker is up and running. You can see connected devices and basic telemetry there. However, you probably do not have devices connected yet.

  4. Unlock full functionality (optional): Purchase a license. See Get a License.

Verify Your Broker Is Running

Log in to the Control Center of your deployed broker. If the Control Center loads and reports the broker as running, the deployment succeeded.

Next Steps