Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

IBM® MQ Light

IBM MQ Light logo


This image contains IBM MQ Light. The Dockerfile for this image can be found on the ibm-messaging GitHub.


In order to use the image, it is necessary to accept the terms of the MQ Light license. This is achieved by specifying the environment variable LICENSE equal to accept when running the image. You can also view the license terms by setting this variable to view. Failure to set the variable will result in the termination of the container with a usage statement.

The following command creates and starts an MQ Light container listening on the host's IP address on port 5672 for AMQP messaging, and 9180 for the web UI. MQ Light's persistent message data and logs are written to a Docker volume in /var/mqlight - in this example, this directory in the container is mapped to the /var/example directory on the host:

sudo docker run \
  --env LICENSE=accept \
  --volume /var/example:/var/mqlight \
  --publish 5672:5672 \
  --publish 9180:9180 \
  --detach \

The following command creates and starts an MQ Light container with security enabled. Note that the mapped ports have changed to be the secure ports.

sudo docker run \
  --env LICENSE=accept \
  --env MQLIGHT_USER=admin \
  --env MQLIGHT_PASSWORD=changeme \
  --env MQLIGHT_TLS_PASSPHRASE=changeme2 \
  --env MQLIGHT_TLS_KEYSTORE=/etc/ssl/selfsigned.p12 \
  --volume /path/on/host/selfsigned.p12:/etc/ssl/selfsigned.p12 \
  --volume /var/example:/var/mqlight \
  --publish 5671:5671 \
  --publish 9181:9181 \
  --detach \

See the MQ Light security tutorial for more details on how to create a key store.

Note: because MQ Light uses memory-mapped files you cannot map /var/mqlight to a vboxsf file system due to VirtualBox defect 819. For example, the /Users directory is typically a vboxsf file system when running under boot2docker on Mac OS X.


The following environment variables can be used to configure MQ Light:

  • LICENSE | Set to "view" to view the license terms, or "accept" to accept the license terms.
  • MQLIGHT_USER | Sets the administrative user name. Must be used in conjunction with MQLIGHT_PASSWORD.
  • MQLIGHT_PASSWORD | Sets the administrative user password. Must be used in conjunction with MQLIGHT_USER.
  • MQLIGHT_TLS_KEYSTORE | Enables SSL/TLS security, and sets the PKCS#12 key store file path. Note that you need to make the key store file available inside your Docker container - for example, you can add a volume by adding -v /path/on/host/my.p12:/path/in/container/my.p12 when you invoke docker run.
  • MQLIGHT_TLS_PASSPHRASE | Sets the passphrase for the key store file, for SSL/TLS security

See the MQ Light documentation for more details about how to use MQ Light.

Issues and contributions

For issues relating specifically to this Docker image, please use the GitHub issue tracker. For more general issue relating to IBM MQ Light you can get help through the Messaging community. If you do submit a Pull Request related to this Docker image, please indicate in the Pull Request that you accept and agree to be bound by the terms of the IBM Contributor License Agreement.


The Dockerfile and associated scripts are licensed under the Apache License 2.0. MQ Light is licensed under the IBM International License Agreement for Non-Warranted Programs. This license may be viewed from the image using the LICENSE=view environment variable as described above or may be found online. Note that this license does not permit further distribution.


Docker image for IBM MQ Light







No releases published


No packages published

Contributors 4