Load Multiple Licenses in Docker Container

HiveMQ Commercial Offerings
1

Hi, we are testing out HiveMQ Enterprise with various options but we have deployed it with Docker. We managed to find the documentation on how to apply a license through the container environment variables (license file > base64 encode > into the license env variable with no line breaks or whitespace). However, for our trial we were provided a whole folder of licenses, not just one. How can we load these multiple files into the docker container?

We are using Portainer to manage the docker instance and containers. Docker is running on Ubuntu linux server (headless). This is the latest HiveMQ version 4.37.

If we need to redeploy outside Docker we can. The container image was easily available and very quick to get started with so we wanted to give it a go.

Can we expose a folder on the docker host with all the license files and connect it to the right path inside the container?

2

Hi @du5tin,

and a warm welcome to the HiveMQ Community! We’re excited that you’re interested in MQTT and the HiveMQ broker. Your presence adds value to our community.

you can expose a folder on the Docker host containing all your license files and mount it inside the container. Here’s the command to do it:

docker run -d --name hivemq \
  -p 8080:8080 -p 1883:1883 -p 8883:8883 -p 8000:8000 \
  -v $(pwd)/my_licenses:/opt/hivemq/license \
  hivemq/hivemq4

Explanation

  • -v $(pwd)/my_licenses:/opt/hivemq/license → This mounts the local folder (my_licenses) containing your license files into the correct path inside the container.
  • -p → Exposes the necessary ports for MQTT, Web UI, and WebSockets.
  • hivemq/hivemq4 → Runs the latest HiveMQ 4 Docker image.

HiveMQ will automatically detect and use the licenses inside /opt/hivemq/license. Let me know if you need further help

Best,
Dasha from The HiveMQ Team