Deploy to Bluemix button example

Share this post:

This blog references DevOps Services at, which has been deprecated. To get the latest tools for agile projects, use IBM Bluemix Continuous Delivery. For more information, see Share your code with the new Deploy to Bluemix button.

The Deploy to Bluemix button is a great way of getting users started with your sample application. In this blog, I will cover a brief introduction to deploying applications on Bluemix, how to create a Deploy to Bluemix button for your own application, and the steps that take place when a developer clicks on the button.

Quick review of applications in Bluemix

When you deploy an application to Bluemix, you have to keep in mind what is actually being deployed. For a mobile app, Bluemix builds and deploys an artifact that represents the mobile app’s backend. This is usually a server written in Node.js or Java. Along with the server, you can also instantiate and bind any Bluemix service from the catalog your application requires. The idea is to have your mobile application talk to this server and then have the server talk to the instantiated services. A Bluemix application is the combination of this server artifact, the collection of required services, and the mobile/web application.

The Deploy to Bluemix button makes it easy for new developers to get started with your application by automating the following:

  • Creates a Bluemix application in the user’s account
  • Instantiates all of the required services and binds them to the created application
  • Deploys the server component on the user’s Bluemix account
  • Creates a IBM Bluemix DevOps Services project on the user’s account with a clone of your repository’s master branch.

Steps to enable the one-click “Deploy to Bluemix” button

For the following instructions, we have the assumptions below:

  • You have a public GitHub repository that has a README and the iOS mobile application source code
  • You have a Bluemix application that uses a Node.js server and a number of Bluemix services. There is no compilation step for your server
  • You wish to add a Deploy to Bluemix button to your README file.

We’ll use the BluePic iOS app as an example of how to create a button. This app uses four Bluemix services and has a Deploy to Bluemix button in its README for developers to use. Try it! You’ll see how one click on this button will handle everything.

There are three main components to get the Deploy to Bluemix button working:

BluePic repository with main components in red

Step 1: Place the button

The first component is the actual Deploy to Bluemix button in your file. Use the following code snippet to create and place the button in your README file by replacing YOUR_GIT_URL_HERE with your repository’s URL. Note: your Git repository must be public.


<a href=""> <img src="" alt="Deploy to Bluemix"></a>


[![Deploy to Bluemix](](

Your README should now have a button like this:

Deploy to Bluemix

Step 2: Add and modify your manifest.yml file

A manifest.yml file placed at the root of the repository specifies which services the app needs. To begin, go to your Bluemix app’s Application Overview page:

Start Coding

Once you’re on this page, open the Start Coding tab and click Download Starter Code:

Download Starter Code

Unzip the folder and locate the manifest file:

Contents of zip file

Modify manifest.yml with the following edits:

  • Add a declared-services field at the top of the file
  • Copy and paste all the entries of services into declared-services, each in its own line
  • For each service under declared-services add a label and plan field. This information can be found by going to the Application Overview and opening the credentials section of each service entry. For example, this is where it would be for the Mobile Client Access service:Service credentials section, label and plan fields boxed in red
  • Edit the path field; it should point to the directory where your server component is located. For our example, the value should be ./NodeStarterCode.

Once finished with the edits, ensure that this file is at the root of your repository. In the end, you should have something like this:

BluePic Manifest

Step 3: Add the server files/folders

The third and final component is the server code that gets deployed to Bluemix. Create a NodeStarterCode folder at the root of the repository. In it, paste all your Node.js server files/folders of your Bluemix Application.

That’s it! At this point your README should have a button for new developers to utilize!

Try your new “Deploy to Bluemix” button!

The following steps will take place once a developer clicks on the button:

  • The master branch of the specified repository will be cloned into new private Bluemix DevOps Services project under the user’s account
  • If a build file was provided, it will be automatically detected and executed. Our example used a server that didn’t require a compilation step so this step is not covered in this blog
  • The manifest file is used to initialize/bind the required services and deploys the application to the user’s account.

Now you can create and put these buttons on any README or webpage desired!


Add Comment
One Comment

Leave a Reply

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


This was really helpful.

More How-tos stories

Tutorial: GitHub Traffic Analytics with Cloud Functions and Cloud Foundry

In a new solution tutorial, I show you how to automatically retrieve and store GitHub traffic data the serverless way with IBM Cloud Functions and Db2. The data can then be analyzed via a Web app deployed to Cloud Foundry on IBM Cloud. The app is secured with App ID using OpenID Connect. The new service Dynamic Dashboard Embedded provides visualization of the views and clones of GitHub repositories.

Continue reading

Cloning an App ID instance configuration

With App ID, you can now manage your service instance with an API!

Continue reading

In-depth Kubernetes Insights with New Relic on IBM Cloud Container Service

At the IBM Cloud Container Service, we were excited about the partnership announcement between IBM Cloud and New Relic. In addition to having another large customer in the platform, we are anxious to test out the New Relic technology and make these capabilities available to users of our container service.

Continue reading