Realtime JavaScript Backend.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
api Merged in master Jun 22, 2018
config Fixed file url config bug Jul 21, 2018
cron Fixing eslint errors Jun 21, 2018
database-connect Fixed file url config bug Jul 21, 2018
databases Linting and checking test build Jun 21, 2018
docs/app-settings Fix broken Markdown headings Apr 17, 2017
exception Lisence on all files added Sep 22, 2016
helpers Linting and checking test build Jun 21, 2018
mail-templates fixed bug in reset password mail template Jun 15, 2016
page-templates Fixed failing tests Jun 19, 2018
sdk Resolved merge conflicts Jun 20, 2018
services Linting and checking test build Jun 21, 2018
test Modified query cloud notification test suites Jul 5, 2018
.dockerignore added node_modules to docker-ignore Sep 6, 2017
.env.sample Added sample environment file Jun 12, 2018
.eslintignore Linting and checking test build Jun 21, 2018
.eslintrc.js Fixed cylic dependencies bug and fixing test Jun 13, 2018
.gitignore Ignored .env file Jun 13, 2018
.snyk fix: package.json & .snyk to reduce vulnerabilities Jun 21, 2018
.travis.yml Fixed travis config Jul 23, 2018 Contributing Document Added Feb 14, 2016 Contributing Document Added Feb 14, 2016 Blocking API done Feb 15, 2016
Dockerfile Modified the base image Jul 5, 2018 Contributing Document Added Feb 14, 2016
LICENSE.txt Deployment script added Feb 10, 2016 Fix broken Markdown headings Apr 17, 2017 Update Jun 2, 2018
credentials.tar.enc Cedentials Encrypted Aug 2, 2016
dump.rdb Added server side validations for defaultValues of columns Jan 10, 2017
env MongoDB security added Oct 17, 2016
gruntfile.js Fixed failing tests Jun 19, 2018
middlewares.js Fixed failing tests Jun 21, 2018
myBinaryFile Staging (#268) Oct 31, 2017
package-lock.json Modified winston logger Jun 21, 2018
package.json Merge pull request #335 from CloudBoost/travis-debug Jul 11, 2018
routes.js Linting and checking test build Jun 21, 2018
server.js Fixed file url config bug Jul 21, 2018
webpack.config.js Fixed failing tests Jun 19, 2018

Build Status OpenCollective

CloudBoost is the complete cloud platform for your app. Think of CloudBoost as Parse + Firebase + Algolia + all combined into one :

  • Data-Storage / JSON Storage / BLOB Storage
  • 100% data ownership
  • Realtime
  • Search
  • More - ACL's, User Authentication, and more.

CloudBoost also has a managed service, so you don't have to install or configure anything. You can sign up for the managed service here.

Deploy with Docker (recommended)

You can install CloudBoost anywhere you like. We have a Docker Compose file that can help you get started with CloudBoost in few minutes and with just one command. You can use this compose file to install the service locally on your local dev machine, or you can install the service to Azure, AWS, DigitalOcean, Softlayer, Packet and more.

Check out our Docker Compose file here.

Running the server without Docker

Important: Before you begin you need to install MongoDB 3.4 and Redis 3.0 on your machine to run this project.

Step 1 : Git clone the project.

git clone

Step 2 : Change directory to CloudBoost.

cd cloudboost

Step 3 : NPM Install.

npm install

Note : NPM requires NodeJS to be installed on your machine. If you don't have NodeJS, you need to install it from here :

Step 4 : Edit cloudboost.json.

Create a config folder in project root if it does not exist. You need to create a new file cloudboost.json under config folder and save that file with MongoDB and Redis configuration. Here's a sample file :

 "mongo" : [{
   "host" : "localhost",
   "port" : "27017"
 "redis" : [{
       "host" : "",
       "port" : 6379       

Step 5 : Edit smtp.json.

In the config folder. Creare a new file called smtp.json. You need to create an account at MailGun ( and get an API Key. This will help CloudBoost to send emails on your behalf. Here's a quick example :

  "provider"  : "mailgun",		
  "domain"    : "",
  "fromEmail" : "",
  "fromName"  : ""  

Step 6 : Enable HTTPS. (Optional)

If you want to enable HTTPS, place your certificate file cert.crt and key key.key in the config folder.

Step 7 : Run the server.

Make sure both Redis and MongoDB are running and then run the CloudBoost server

node server.js

Once the server is running. You'll see the ClusterKey and SecureKey on the console whcih means you've successfully started CloudBoost. If you don't see any of these keys, please raise a GitHub issue and let us know.

Once the server is running, You can

Once started, you'll see the CloudBoost Secure Key on the console. This is important, Please save it for future use. Secure Key helps you create / delete apps.

Create an app

To create an app, You need to :

        URL : <YOUR_SERVER_URL>/app/<APP ID>
        REQUEST BODY :
            secureKey : YOUR_SECURE_KEY

For Example (in curl) :

curl -H "Content-Type: application/json" -X POST -d '{"secureKey":"xxxxxx-yyyy-xxxx-yyyyy-xxx"}' http://localhost:4730/app/app1

Creating a table

Table lets you store any structured data in your app. To create one, check this documentation out.

Delete an app

To delete an app, You need to :

        URL : <YOUR_SERVER_URL>/app/<APP ID>
        REQUEST BODY :
            secureKey : YOUR_SECURE_KEY

For Example (in curl) :

        curl -H "Content-Type: application/json" -X DELETE -d '{"secureKey":"xxxxxx-yyyy-xxxx-yyyyy-xxx"}' http://localhost:4730/app/app1

Once your app is ready, You can then get the latest SDK from Remember to save the SDK in your project. and You can then init your app by :

CB.CloudApp.init('Your Server URL', 'Your App ID', 'Your App Key');

You can then follow rest of the documentation from You can also check out API Reference on

JavaScript SDK

JavaScript SDK can be found in the sdk folder of this repo.

NPM Installation

npm install cloudboost

NodeJS Usage

var CB = require('cloudboost');

Bower Installation

bower install cloudboost

JavaScript Usage

<script src="bower_components/cloudboost/dist/cloudboost.js"></script>

Module Bundlers

// For ES6/ES7 , TypeScript(typings included)
import * as CB from 'cloudboost';

//For ES5 (requireJs)
var CB = require('cloudboost');

Sample Code

// AppID and AppKey are your App ID and key of the application created in CloudBoost Dashboard.

//Init your Application

//Data Storage : Create a CloudObject of type 'Custom' (Note: You need to create a table 'Custom' on CloudBoost Dashboard)

var obj = new CB.CloudObject('Custom');

//Set the property 'name' (Note: Create a column 'name' of type text on CloudBoost Dashboard)

//Save the object{
        console.log("object saved successfully");
        console.log("error while saving object");

Cluster Maintenance, Scale, and Updates

CloudBoost runs on MongoDB and Redis. You're responsible for managing the uptime, replication, sharding, backups of your data in each of these databases.

You also need to update CloudBoost with every new release and you need to configure your server to auto-scale it. If you're using Docker, the image is released at the latest tag and you need to check for new releases atleast once a month.

Using our hosted and managed service helps you to save time, development costs, and eliminates managing your own cluster of servers which is cheaper long-term. We recommend using the hosted service if you're running production apps.

App Settings

To read more about app settings, check Click here



Tests are in a seperate repository. You can find them here.


Pull requests are very welcome!

We'd love to hear your feedback and suggestions in the issue tracker.


If you're using CloudBoost Open Source and like what we've built, help us speed development by being a backer. [Become a backer]


Copyright 2016 HackerBay Software Private Limited.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.