Skip to content

ibm-messaging/mq-container

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Sravani ShibbalaGitHub Enterprise
Sravani Shibbala
and
GitHub Enterprise
Mar 11, 2025
7924731 · Mar 11, 2025
Jul 16, 2024
Jan 23, 2025
Dec 9, 2024
Feb 6, 2025
May 24, 2024
Oct 15, 2024
May 31, 2024
Feb 10, 2025
Jun 30, 2020
Jun 4, 2024
Feb 10, 2025
Jan 16, 2025
Mar 10, 2025
Jan 23, 2025
Aug 27, 2024
Mar 28, 2018
Nov 22, 2023
Mar 5, 2025
Mar 10, 2025
Feb 7, 2025
Sep 7, 2017
Mar 11, 2025
Apr 10, 2018
Jan 10, 2019
Feb 10, 2025
Sep 15, 2023
Nov 19, 2024
Nov 18, 2024
Oct 16, 2024
Mar 10, 2025
Mar 10, 2025
Jan 14, 2025
May 14, 2024
Oct 19, 2023
Feb 18, 2025
Feb 1, 2023

Repository files navigation

IBM MQ container

Build Status

Note: The master branch may be in an unstable or even broken state during development. To get a stable version, please use the correct branch for your MQ version, instead of the master branch.

Overview

Run IBM® MQ in a container.

You can build an image containing either IBM MQ Advanced, or IBM MQ Advanced for Developers. The developer image includes a default developer configuration, to make it easier to get started. There is also an incubating folder for additional images for other MQ components, which you might find useful.

Build

After extracting the code from this repository, you can follow the build documentation to build an image.

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.

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.
  • MQ_QMGR_NAME - Set this to the name you want your Queue Manager to be created with.
  • MQ_QMGR_LOG_FILE_PAGES - Set this to control the value for LogFilePages passed to the "crtmqm" command. Cannot be changed after queue manager creation.
  • MQ_LOGGING_CONSOLE_SOURCE - Specifies a comma-separated list of sources for logs which are mirrored to the container's stdout. The valid values are "qmgr", "web" and "mqsc". Defaults to "qmgr,web".
  • MQ_LOGGING_CONSOLE_FORMAT - Changes 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_LOGGING_CONSOLE_EXCLUDE_ID - Excludes log messages with the specified ID. The log messages still appear in the log file on disk, but are excluded from the container's stdout. Defaults to "AMQ5041I,AMQ5052I,AMQ5051I,AMQ5037I,AMQ5975I".
  • MQ_ENABLE_METRICS - Set this to true to generate Prometheus metrics for your Queue Manager.

See the default developer configuration docs for the extra environment variables supported by the MQ Advanced for Developers image.

Kubernetes

If you want to use IBM MQ on Kubernetes, you can find an example Helm chart here: IBM MQ Sample Helm Chart. This can be used to run the container on a Kubernetes cluster, such as the IBM Cloud Kubernetes Service. Apart from sample Helm chart, from IBM MQ v9.4.1, you can also follow the steps in this page to deploy on Kubernetes.

Issues and contributions

For issues relating specifically to the container image or Helm chart, please use the GitHub issue tracker. Pull requests are not currently accepted.

License

The Dockerfiles and associated code and scripts are licensed under the Apache License 2.0. Licenses for the products installed within the images are as follows:

  • IBM MQ Advanced for Developers (International License Agreement for Non-Warranted Programs). This license may be viewed from an image using the LICENSE=view environment variable as described above or by following the link above.
  • IBM MQ Advanced (International Program License Agreement). This license may be viewed from an image using the LICENSE=view environment variable as described above or by following the link above.

Note: The IBM MQ Advanced for Developers license does not permit further distribution and the terms restrict usage to a developer machine.

Copyright

© Copyright IBM Corporation 2015, 2024