Start and manage (http) worker process for nodejs
JavaScript Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Usage example at

var pstarter = require('pstarter');

pstarter.startMaster(__dirname + '/config/configs.js', {}, function() {
	var config = require('./config/configs.js');
	pstarter.statServer(config.http.statPort, config.http.statHost);
	if (process.env['NODE_ENV'] && process.env['NODE_ENV'] == 'development') {
		pstarter.startWatch(__dirname, [__dirname +'/node_modules'], ['.js', '.json', '.html', '.css']);
}).startWorker(function() {
	var config = require('./config/configs.js');

	var express = require('express');
	var bootstrap = require('./app/bootstrap.js');
	var app = express.createServer();

	bootstrap.setupApp(app, __dirname);
	app.listen(config.http.port, config.http.ip);

Or run separate worker file


var pstarter = require('pstarter');

pstarter.startMaster({}, {exec: './worker.js'});


var pstarter = require('pstarter');
pstarter.startWorker(function() {
	console.log('Hello world!');


startMaster(confFile, masterSettings, callback)

startWorker(callback, cleanupCallback)

  • callback - will call when worker has attached listener on exit signal
  • cleanupCallback - will call when worker receives exit signal. It pass a function for terminating process (or you can choose to exit).

startWatch(root, skipFolders, exts)

  • root top folder to watch, all subfolder will also be watched
  • skipFolders Array of folders you want to skip, absolute path
  • exts Array of extension to listen on changes, including "."

statServer(port, host)

  • port port to run stat server
  • host host to run stat server

Start with init script on Ubuntu

You need to create a symbolic link /etc/init.d/pstarter to pstarter/etc/init.d/pstarter and make pstarter executable. You need also specify NODE_BIN, SERVER, PID_FILE, AS_USER, NODEJS and NODE_ENV if your application uses it:

  • NODE_BIN folder which contains SERVER
  • SERVER application/server file to execute
  • PID_FILE should be /var/run/ in production linux
  • AS_USER the username or uid that you want to run your app (worker) with
  • NODEJS executable nodejs
  • NODE_ENV for your own application; normally development/production

Start workers

sudo /etc/init.d/pstarter start

Old workers will exit directly and new workers created

sudo /etc/init.d/pstarter restart

Old workers will exit graceful one at the time and replaced with a new one

sudo /etc/init.d/pstarter graceful

Run stop (bellow) and start command will be executed

sudo /etc/init.d/pstarter force-restart

Old workers exit directly; parent exits

sudo /etc/init.d/pstarter stop

Register init script for startup at reboot in Ubuntu

cd /etc/init.d/
sudo update-rc.d pstarter defaults