Install HiveMQ Software with Docker

Deploy the HiveMQ broker as a Docker container using the official HiveMQ image.

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

Before You Begin

Install Docker on the machine where you want to run the broker. For installation instructions, see the Docker documentation.

Steps

  1. In your terminal, run the following command:

    docker run -p 8080:8080 -p 1883:1883 hivemq/hivemq4:latest

    Docker pulls the HiveMQ image and starts the container. Port 8080 serves the Control Center and port 1883 accepts MQTT client connections.

  2. Open http://localhost:8080 in a browser.

    If you run Docker on a remote machine, replace localhost with the IP address of that machine.

  3. Log in to the HiveMQ Control Center with the following default credentials:

    Username

    admin

    Password

    hivemq

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

Next Steps