Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple multi-CPU cluster server manager for Node 0.6+
JavaScript LiveScript
branch: master


Simple multi-CPU cluster server manager for Node 0.6+


npm i cluster-server


    // require('cluster-server')(port, host, cb);
    // port defaults to 8888, host defaults to ""
    require('cluster-server')(function() {
      var express = require('express');
      var app = express.createServer();
      app.get('/', function(req, res) {
        return res.send("Hello, World");
      return app; // calls app.listen(port, host) automatically


This module pre-forks several workers, calls the supplied function in each of the workers, and pings each worker every second to restart any workers that were stuck or terminated.

The number of workers is require('os').cpus().length, with a minimum of 3 and a maximum of 6.

It also handles INT, TERM, KILL and QUIT signals and terminates the workers accordingly. However, setsid(1) is still recommended so workers can terminate when the master is killed by an non-catchable signal.

See Also

(Same idea, but without polling for "stuck" workers)


To the extent possible under law, 唐鳳 has waived all copyright and related or neighboring rights to node-cluster-server.

This work is published from Taiwan.

Something went wrong with that request. Please try again.