September 2017 Update: The IBM Bluemix container service now also supports Kubernetes clusters, so you will probably want to check out this newer article instead!

We’ve previously blogged about how the Containers Service in the IBM Bluemix hosted cloud environment can be used to quickly get an IBM Integration Bus docker environment up and running. Recently, the process has become even easier. In fact 10 steps has become just 3 steps! So, before you’re tempted to continue your web surfing elsewhere, why not try it out right now? If you follow along the steps below I guarantee you’ll have your IIB environment up and running in less than the time it takes to make a cup of tea.

1. First, login to Bluemix. The screens shown below, start from the Bluemix Containers dashboard in my organization (named and my space (named IIBspace). If this is your first time logging in to your organization, then you’ll need to create a space first. Once you have a space, click the button to Create Containers:


If you have never used the container service before, you will be prompted to specify a name for your registry of container images:


Once you save, you will be presented with a set of icons representing the available pre-built images:


Click on the ibm-integration-bus image.

2. Now we will instantiate a running container from the pre-built IIB image, which contains the software package for IBM Integration Bus for Developers (also known as Developer Edition). This is a full-function version of the product that you can use for development purposes which is supplied free of charge. Type a container name, such as Ben_IIB_Container, select the container size (you can go right up to the Medium size free of charge), and in the Public IP address field, select Request and Bind Public IP. Leave the Public ports property with the default settings of 4414 (this will be the IIB administration port) and 7800 (this is the default port which IIB uses for HTTP traffic):


This next bit is very important, so definitely don’t miss this bit out! Scroll down a little further and in the Advanced Options section, click the link to Add a new environment variable. Add three environment variables with the following values

  • LICENSE with a value of accept
  • NODENAME with a value of BENNODE (where BENNODE is your chosen IIB node name)
  • LOG_LOCATIONS with a value of /var/log/syslog (this specifies the logs from inside the container that you want to expose through the Bluemix UI)

Note: If you do not specify values for the LICENSE and NODENAME properties, the container will be created but it won’t start!

Click on the Create button and the container should be created and started!

3. You should be presented with a view of your IIB container up and running as shown below (there may be a delay of a few seconds during which time you might see a reported status of “Building” or “Networking”):


Scroll down the Overview page and you should find your public IP address:


Copy the IP address and use it with the port 4414 in a new web browser tab and you should be able to interact with your IIB container via the IIB web user interface:


Stop the clock! Three easy steps and you’re now running IBM Integration Bus in Bluemix in the Container Service … now go make that well deserved cup of tea!

For more detailed information about this capability, check out our documentation here

7 comments on"Run IBM Integration Bus in Bluemix in 3 Easy Steps!"

  1. Is this article is obsolete now? As I see containers are managed by kubernetes in bluemix now.

    • BenThompsonIBM September 04, 2017

      Yes, the IBM Bluemix Container Service now allows you to use Kubernetes managed clusters of containers rather than single containers. Accordingly we’ve updated with a link to a new how-to article at the top of this page!

  2. Hi Ben,

    I am trying to follow the steps, but it is not allowing to create single/scalable container anymore. It asks to create a Kubernetes cluster. And I am not able to create that too. Do you think I am doing something wrong here?

    • BenThompsonIBM September 04, 2017

      Hi Ankur, you can run IIB in a container using Kubernetes as part of the IBM Bluemix Container Service … and we’ve just added a link to a new article describing how to get up and running.

  3. Hi Team,

    Could you please let me advice one usecase confirmation ?

    I want to transfer account name & Website information from Salesforce to bluemix through api . Could you please confirm ?


    • BenThompsonIBM July 17, 2017

      Hi Rajat,

      Thanks for your comment asking about how to use IBM’s integration offerings to expose a Salesforce trigger (eg account name) and invoke an API, hosted somewhere in Bluemix. We’ve seen this question has been posed on a couple of articles related to IIB – how to run IIB in a Bluemix container, and also one about how IIB can be used to expose a REST API interface and then call out to Salesforce. IIB is one option in this space, but there is also App Connect (which can expose triggers and actions) which you might want to consider as this provides support for Salesforce events. In fact there is a recent video which we’ve released that uses Salesforce inputs (triggers) and also happens to showcase how to invoke IIB from App Connect:

      There are lots of considerations in this space dependent on your detailed use case, so if you’d like to drop us a private email to discuss specifics then please do so!


  4. Ben,

    Was able to create my own image and push it into my bluemix space. Was also able to start the container successfully(“bx ic start “) . But how do I get in to command line of that IIB container?. When i executed
    “bx ic exec -it /bin/bash” – get the below error
    rpc error: code = 2 desc = oci runtime error: exec failed: exec: “C:/Program Files/Git/usr/bin/bash”: stat C:/Program Files/Git/usr/bin/bash: no such file or directory.

    What am I missing?.Kindly help


Join The Discussion

Your email address will not be published. Required fields are marked *