Skill Level: Beginner


Boilerplate services provide ready to use sample application deployments. Node-RED Starter service provides you a combo of Cloudant NoSQL DB and SDK for Node.js ( Node-RED user interface) together. The deployment shall expedite IoT Application development



  1. Introduction

    IBM Bluemix Catalog provides you with over 140 services that shall help manage various aspects of your IT requirements. However, a developer would be interested in a service or set of services that shall expedite the process of configuring the IoT Application Development & deployment environment.

    The Boilerplates section within the Bluemix Catalog, offers you with set of ready to use one or more services, that are binded together with an Application of choice. In the scope of this IoT Recipe, let us understand what Node-RED Starter service has, in the offering.

  2. Deploy Node-RED Starter service

    The Node-RED Starter service helps you deploy SDK for Node.js as your Application, followed by a Cloudant NoSQL DB service, which in turn is binded to your Application, as the default DB for your IoT requirements. Node-RED shall be the default User Interface and is considered one of the fastest means to begin your IoT Application development.

    1. Log into IBM Bluemix account and access the Catalog
    2. Choose to click on the Node-RED Starter service


    3. Provide a unique App Name, which shall be any custom name to your application


    4. Select a plan of choice for SDK for Node.js & Cloudant NoSQL DB


    5. Click on Create, provided on the bottom-right corner of the screen, to go ahead and deploy the Starter service
    6. The deployment process takes couple of minutes to complete.
    7. Post successful deployment, you should see your application with an Up & Running status along with the Application URL


    8. Parallelly, you should also get to see your Application listed under All Apps section of your Bluemix Dashboard.


    This section helped you to successfully deploy the Node-RED Starter, a service available under the Boilerplates section within the Bluemix Catalog.

  3. Getting started with your Node-RED Starter Application

    In this section you shall be introduced to the set of steps that help you get started with the Node-RED Application.

    1. Steps #7 and #8 in the previous section, provided you with option to launch the Node-RED Application, using the application URL
    2. As the Application launches, it prompts you to complete couple of steps: Secure the Node-RED Editor and Browse available nodes


      Click on Next to continue

    3. To secure your Node-RED Editor and the flows associated with it, configure the credentials with a custom User ID and Password of your choice. Optionally, choose to grant access public in Read-Only mode or grant Write permission to all.


      Click on Next to continue.

    4. The next screen displays a set of Node-RED nodes that are publicly available, whose services you can plan to leverage as part of your current application. Choose to include them or you can do so at a later stage


    5. The last step in the configuration process summarizes your selections & choices. Click on Finish to complete the Application configuration


    6. The Configuration choices made shall take couple of moments to be applied to your current Application environment


    7. Post applying your Configuration settings, you are now good to start with your Node-RED editor. Click on the Go to your Node-RED flow editor to launch the editor and get started with your first flow.


    Thus, you’ve successfully configured your Node-RED environment and have launched the Node-RED Editor, to begin with your IoT Programming, using a simple action of Drag-n-Drop of Nodes.¬†

  4. Conclusion

    The IoT Recipe Deploy Node-RED Starter Boilerplate service successfully demonstrated on the set of steps to deploy and configure your IoT Platform Starter environment along with the Node-RED Application.

    As a next step in configuring your IoT environment, go ahead and include the Watson IoT Platform service to your Application. The IoT Recipe How to Register Devices in IBM Watson IoT Platform shall guide you with the set of steps. Register your sensors / devices with Watson IoT Platform, push data into and pull data from it using your Node-RED Application, with Cloudant NoSQL DB acting as the default DB for your IoT environment.

Join The Discussion