The IBM® MQ Light Developer Tools use the MQ Light API (based on AMQP 1.0), and provide a messaging runtime that developers can install, configure, and use to write applications in just a few minutes, enabling developers to quickly create scalable and responsive applications. This page will help you get up and running with MQ Light Developer Tools – for more information on the product, see Product Overview.

Obtaining an MQ Light client

Installing the MQ Light Developer Tools

The MQ Light Developer Tools provide a convenient deployment process for developers. Note that before you start, you may wish to check the Supported Platforms and Software pre-requisites.

There is no installer; you download and extract the .zip or tar.gz file to a chosen directory. No specific permissions are required to install or run the MQ Light Developer Tools, so you can install it to a home directory.


Having obtained the required file for your platform, the Developer Tools can be installed by extracting the .zip or tar.gz to a folder of your choice. Once the extraction has completed, the MQ Light Developer Tools are installed and ready to be started.


Use the mqlight-start command to start the messaging runtime environment.


The MQ Light User Interface (which is included as part of the Developer Tools) contains several built in tutorials, to help you get up and running writing MQ Light apps. These include a Hello World! tutorial, which sends a short message between one connected sending client and one receiving client, and a UI Workout tutorial, which demonstrates the user interface handling a larger data load.
The following tutorials are located in the Documentation tab of the MQ Light User Interface:

  • Hello World!
  • Worker Offload
  • UI Workout

When a tutorial is selected, the View Messages tab is opened, with a new panel containing the instructions required to complete the tutorial. As the steps are completed, you can see the user interface handle clients, messages, and receivers.


The MQ Light API has been developed for Windows and Linux, with a development license version also available on Mac OS X. See below for a list of the platforms that the MQ Light API has been developed for, plus a list of browsers we have tested the MQ Light User Interface on:

For Windows operating system:

  • Windows 7 SP1 Professional (x86-64)
  • Windows Server 2008 Standard (x86-64)
  • Windows 8 Enterprise (x86-64)
  • Windows 8.1 Enterprise (x86-64)

For Linux operating system:

  • Ubuntu Linux 12.04 LTS (x86-64)
  • Ubuntu Linux 14.04 LTS (x86-64)
  • Red Hat Enterprise Linux Server 6 (x86-64)
  • Red Hat Enterprise Linux Server 7 (x86-64)

Web browsers for the MQ Light User Interface:

  • Mozilla Firefox (24 or higher)
  • Microsoft Internet Explorer (10 or higher)
  • Google Chrome (34 or higher)
  • Apple Safari (5.1 or higher)

For Mac OS X operating system:

A development license version of MQ Light is also available, on the following Mac OS X (x86-64) operating systems:

  • OS X 10.8 (Mountain Lion)
  • OS X 10.9 (Mavericks)
  • OS X 10.10 (Yosemite)

Software pre-requisites

Before using the MQ Light API on Linux, you must have the libuuid package installed.


To check whether you have the package installed on your platform, run:

  • On Ubuntu:
    dpkg -l libuuid1
  • On RedHat:
    rpm -qa | grep libuuid

3 comments on"Getting started with the MQ Light Developer Tools"

  1. March 02, 2018

    can this help me to connect MQ in mainframe to connect with Node JS running on cloud? is there a specific documentation to help?

    Vivekananda K

  2. Otavio de Aguiar July 19, 2017


    I am trying to run mqlight-start on a Mac machine but all I get is:
    AMQ6109: An internal IBM MQ error has occurred.

    How do I troubleshoot it?


    • I did it this way on Mac:
      1. export JAVA_HOME=/mqlight-developer-
      2. export PATH=$JAVA_HOME/bin:$PATH
      3. run server in foreground to see output: runtime/wlp/bin/server run

      objc[54559]: Class JavaLaunchHelper is implemented in both /Users/juozasbaliuka/Downloads/mqlight-developer- (0x1065654c0) and /Users/juozasbaliuka/Downloads/mqlight-developer- (0x106eb04e0). One of the two will be used. Which one is undefined.
      Launching defaultServer (WebSphere Application Server on Java HotSpot(TM) 64-Bit Server VM, version 1.8.0_144-b01 31_Jul_2017_10_49 Mac OS X x64(SR4 FP10) (en_US)
      [AUDIT ] CWWKE0001I: The server defaultServer has been launched.
      [AUDIT ] CWWKZ0058I: Monitoring dropins for applications.
      [AUDIT ] CWWKF0012I: The server installed the following features: [servlet-3.0, jsp-2.2].
      [AUDIT ] CWWKF0011I: The server defaultServer is ready to run a smarter planet.

Join The Discussion

Your email address will not be published.