Install HiveMQ Software on Kubernetes

Deploy HiveMQ on Kubernetes using the HiveMQ Platform Operator and Helm.

To access the Kubernetes deployment wizard, follow the steps in Add HiveMQ Software, then select Kubernetes.

Before You Begin

Confirm that your environment meets the following requirements:

  • Kubernetes 1.24.x or higher

  • Helm 3.10.x or higher

  • Kubernetes command-line tool kubectl

Steps

  1. In your terminal, run the following command to add the HiveMQ Helm repository and install the HiveMQ Platform Operator:

    # Add the HiveMQ Helm repository to your local Helm setup
helm repo add hivemq https://hivemq.github.io/helm-charts && \
helm repo update && \

# Install the HiveMQ Platform Operator
helm install hivemq-platform-operator hivemq/hivemq-platform-operator \
  --rollback-on-failure \
  --create-namespace \
  -n hivemq-platform-operator

  2. Run the following command to install the HiveMQ Platform:

    helm install hivemq-platform hivemq/hivemq-platform \
  --rollback-on-failure \
  --create-namespace \
  -n hivemq \
  --wait

    The Platform Operator deploys HiveMQ in your Kubernetes cluster.

  3. Run the following command to forward the Control Center port to your local machine:

    kubectl port-forward svc/hivemq-hivemq-platform-cc-8080 8080 -n hivemq

  4. Open http://localhost:8080 in a browser and log in with the following default credentials:

    Username

    admin

    Password

    hivemq

    MQTT clients can connect on port 1883.

  5. Add your HiveMQ Platform license to unlock full broker capabilities. See Install a HiveMQ License.

Next Steps