node package manager


Manage cluster applications with email alerting on crash of worker


To manage apps that want to use nodejs cluster module. This module will restart workers on failure and allows rolling restarts. It can send email notifications on worker failure.

npm install -g cluster-manager
var clusterManager = require('cluster-manager');
    workers: 5,
        subjectPrefix:"SUBJECT PREFIX"

Below are the keys that can be set in the JSON object. They are all optional except for exec.

node application that will be started by the cluster
<dd>number of workers that will be spawned. Default:2</dd>

<dd>File to store the ID for the main process. Used to send signals to the cluster manager</dd>

<dd>Object with a <i>from</i>, <i>to</i> and <i>subjectPrefix</i> property. If set, the recipient will receive email notifications on events that affect the workers. To send notifications, it requires __/usr/lib/sendmail__.</dd>

<dd>Handles if the cluster-manager will be verbose in its messages. Default:false</dd>

<dd>Determines if the worker stdout streams are silent. Default:false</dd>

<dd>Object with the environment variables passed on to the workers</dd>

<dd>How long to wait after reloading workers to confirm reload was successful. After this time, the old workers will be shut down.</dd>

<dd>How long to wait before the cluster manager will force a worker to shutdown after the initial shutdown request</dd>

While the cluster manager is running, you can send signals.

*To reload workers - start new ones and shut down the old ones.


*To output to stdout number of workers and their PIDs


*To increase running workers to the maximum number set at the start


*To attempt graceful shutdown


The npm module for this library is maintained by:

cluster-manager is licensed under the MIT license.