ibmcom/mq

By ibmcom

Updated about 3 years ago

IBM® MQ Advanced for Developers

Image
150

10M+

Deprecated

Versions of IBM MQ after 9.2.4 are no longer hosted on Docker Hub. Instead, you can download the latest version from the IBM Container Registry.

IBM® MQ is messaging middleware that simplifies and accelerates the integration of diverse applications and business data across multiple platforms. It uses message queues to facilitate the exchanges of information and offers a single messaging solution for cloud, mobile, Internet of Things (IoT) and on-premises environments.

By connecting virtually everything from a simple pair of applications to the most complex business environments, IBM MQ helps you improve business responsiveness, control costs, reduce risk—and gain real-time insight from mobile, IoT and sensor data.

Maintained images

There are no actively maintained images on Docker Hub. Instead, use IBM Container Registry:

  • MQ Advanced for Developers 9.3.0: icr.io/ibm-messaging/mq:9.3.2.0-r2

Unmaintained images

Tags and respective Dockerfile links for images which are no longer actively maintained with security fixes, or use MQ versions which are no longer in support. You are recommended to avoid use of these images, but they are left for compatibility reasons, and may be withdrawn at any time:

All images are “Continuous Delivery” (CD) releases, and are available for download for up to one year (from 9.1.0.0 onwards), with new CD releases superseding older versions. If you want to use MQ V8.0.0 or V9.0.0, see this sample for how to build your own image.

Quick reference

Overview

Run IBM® MQ Advanced for Developers in a container.

Usage

See the usage documentation for details on how to run a container.

Note that in order to use the image, it is necessary to accept the terms of the IBM MQ license by setting the LICENSE environment variable.

Environment variables supported by this image

  • LICENSE - Set this to accept to agree to the MQ Advanced for Developers license. If you wish to see the license you can set this to view.
  • LANG - Set this to the language you would like the license to be printed in.
  • LOG_FORMAT - Set this to change the format of the logs which are printed on the container's stdout. Set to - "json" to use JSON format (JSON object per line); set to "basic" to use a simple human-readable format. Defaults to "basic".
  • MQ_QMGR_NAME - Set this to the name you want your Queue Manager to be created with.
  • MQ_ENABLE_METRICS - Set this to true to generate Prometheus metrics for your Queue Manager.
  • MQ_DEV - Set this to false to stop the default objects being created.
  • MQ_ADMIN_PASSWORD - Changes the password of the admin user. Must be at least 8 characters long. Default is passw0rd.
  • MQ_APP_PASSWORD - Changes the password of the app user. If set, this will cause the DEV.APP.SVRCONN channel to become secured and only allow connections that supply a valid userid and password. Must be at least 8 characters long. Default is blank (no password required) for MQ clients, and passw0rd for HTTP clients.
  • MQ_TLS_KEYSTORE - DEPRECATED: see "Supplying TLS certificates". Allows you to supply the location of a PKCS#12 keystore containing a single certificate which you want to use in both the web console and the queue manager. Requires MQ_TLS_PASSPHRASE. When enabled the channels created will be secured using the TLS_RSA_WITH_AES_128_CBC_SHA256 CipherSpec. Note: you will need to make the keystore available inside your container, this can be done by mounting a volume to your container.
  • MQ_TLS_PASSPHRASE - DEPRECATED: see "Supplying TLS certificates". Passphrase for the keystore referenced in MQ_TLS_KEYSTORE.

See the default developer configuration docs for more information about the default developer configuration supported by the MQ Advanced for Developers image.

Kubernetes

If you want to use IBM MQ in Kubernetes, you can find an example Helm chart here: IBM charts. You can find more information about using IBM MQ in Kubernetes here.

Copyright

© Copyright IBM Corporation 2015, 2022

Docker Pull Command

docker pull ibmcom/mq