Page Contents


IBM MQ Light® is a simple yet powerful AMQP-based messaging API. The loopback-connector-mqlight module is the Loopback connector for IBM MQ Light.

The LoopBack MQ Light connector supports:


Enter the following in the top-level directory of your LoopBack application:

$ npm install loopback-connector-mqlight --save

The --save option adds the dependency to the applications package.json file.


Use the data source generator to add the MQ Light data source to your application. The resulting entry in the application’s server/datasources.json will look something like this:

"mymq": {
  "name": "mymq",
  "connector": "mqlight"

Edit server/datasources.json to add other supported properties as required:

"mydb": {
  "name": "mymq",
  "connector": "mqlight",
  "username": <username>,
  "password": <password>,
  "service": <service URI>

The following table describes the connector properties.

Property Type Description
service String Connection URI for MQ Light service
username String MQ Light service username
password String MQ Light service password associated with the username above

Examples can be found in the test directory.


Start a local MQ Light server:

$ $MQLIGHT_HOME/mqlight-start

You can download a free copy at

Then run the tests:

$ npm test

We run tests against the latest developer builds. Early access builds are not guaranteed to pass (use at your own risk).