paasmaker-interface-nodejs /

Paasmaker node.js interface

This is a helper library for node.js applications deployed with Paasmaker.

You can read more about the Paasmaker platform as a service at

To install

Simply use npm:

$ npm install paasmaker

Source code for the library is on BitBucket and GitHub.

In your application

Require the library and then create a new instance:

var paasmaker = require('paasmaker');

var pm = new paasmaker();

The new instance object has a few important properties, listed below.


The port number that your application should listen on. This is assigned to your app by Paasmaker's router so it doesn't conflict with other running apps.


This is a hash of connection information returned by Paasmaker service plugins (databases, caches, etc.).

For example, if you have the mongoDB plugin enabled, your services object might look like this:

  "services": {
    "mongodb": {
      "hostname": "",
      "port": 1234

Local development with configuration files

For local development (not running on Paasmaker), you can provide an array of files to load to the paasmaker() constructor.

Alternatively, consider setting up a local instance of Paasmaker and using the development directory plugin.

Example application

var http = require('http');
var paasmaker = require('paasmaker');

var pm = new paasmaker();

http.createServer(function (req, res) {
  res.end("Hello, world!", 'utf8');


Because error handling in Node is complicated, we've taken the simple way out of just throwing exceptions. In normal use, though, you can expect your application to only have two states: running (with the correct configuration set) and not running.


This interface library is released under the MIT License. Paasmaker itself is licensed under the MPL v2.