Home » Categories » Multiple Categories

How To Write a Linux Daemon with Node.js


A daemon is a program that runs in background and has no controlling terminal. They are often used to provide background services. For example, a web-server or a database server can run as a daemon.

This tutorial will show you how to write a daemon with Node.js and deploy it on your server with Upstart.

I will focus on implementing a standard daemon. I'm using upstart just for simplicity, however you can write a System-V init script or use anything you like to start your daemon.


For this tutorial, you will need a Linux server(Preferably Ubuntu or CentOS), Node.js, and Upstart.


There are several ways to install Node.js. The easiest way in my opinion is to use nvm. It also allows you to manage different versions of Node.

Alternatively, you can follow one of these guides:

  1. How To Install an Upstream Version of Node.js on Ubuntu 12.04
  2. Installing Node.js via package manager


Upstart comes pre-installed on many Linux distros. If it's not installed on the distro of your choice, you should be able to install it from official repositories. You can also compile it from the source-code. Refer to Upstart Getting Started page for more info.

How Daemons Work

Basically a daemon starts like a normal process. the following will occur afterwards:
  1. It creates a copy of itself as it's child process.
  2. The child detaches itself from the parent process.
  3. The child process closes its standard file descriptors (See below.)
  4. The parent process exits.
  5. The daemon continues its work in background.

Instead of closing the standard file descriptors, the parent process can open the null device and attach it to the child's standard file descriptors.

The Example Daemon

For the sake of this tutorial, we're going to create a simple HTTP daemon.

Our daemon will be able to:

  1. Start in the background (we're going to use a module called "daemon" for this.)
  2. Spawn multiple workers for HTTP server.
  3. Restart the workers on SIGHUP.
  4. Terminate the workers on SIGTERM.
  5. Drop workers' privileges after the HTTP server gets started.

Initial project structure

The following is the initial project structure:

|-- README.md
|-- bin/
|   `-- node-simple-http-daemon
`-- lib/
    `-- app.js


Let's start by creating a package.json file:

$ npm init

Install daemon module:

$ npm --save install daemon

And here is how the package.json should look like:

  "name": "node-simple-http-daemon",
  "version": "0.0.0",
  "description": "Simple HTTP Daemon written in Node.js",
  "main": "lib/app.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "start": "node lib/app.js"
  "author": "Fardjad Davari",
  "license": "MIT",
  "dependencies": {
    "daemon": "~1.1.0"

Note that we added a start script, So we can start the app with npm start command later.

HTTP Server

For now, we're going to create a simple HTTP server that starts listening on port 80 and responds with "Hello world" for every request.

Put the following in lib/app.js file:

 * lib/app.js

const PORT = 80;
const ADDRESS = '';

var http = require('http');

var server = http.createServer(function (req, res) {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello World\n');

server.listen(PORT, ADDRESS, function () {
    console.log('Server running at http://%s:%d/', ADDRESS, PORT);
    console.log('Press CTRL+C to exit');

You can start the server by running sudo npm start.

Daemon executable

The following is the daemon executable code.

The following should be placed in bin/node-simple-http-daemon:

#!/usr/bin/env node

 * bin/node-simple-http-daemon

// Everything above this line will be executed twice

var cluster = require('cluster');

// Number of CPUs
var numCPUs = require('os').cpus().length;

 * Creates a new worker when running as cluster master.
 * Runs the HTTP server otherwise.
function createWorker() {
  if (cluster.isMaster) {
    // Fork a worker if running as cluster master
    var child = cluster.fork();

    // Respawn the child process after exit
    // (ex. in case of an uncaught exception)
    child.on('exit', function (code, signal) {
  } else {
    // Run the HTTP server if running as worker

 * Creates the specified number of workers.
 * @param  {Number} n Number of workers to create.
function createWorkers(n) {
  while (n-- > 0) {

 * Kills all workers with the given signal.
 * Also removes all event listeners from workers before sending the signal
 * to prevent respawning.
 * @param  {Number} signal
function killAllWorkers(signal) {
  var uniqueID,

  for (uniqueID in cluster.workers) {
    if (cluster.workers.hasOwnProperty(uniqueID)) {
      worker = cluster.workers[uniqueID];

 * Restarts the workers.
process.on('SIGHUP', function () {
  createWorkers(numCPUs * 2);

 * Gracefully Shuts down the workers.
process.on('SIGTERM', function () {

// Create two children for each CPU
createWorkers(numCPUs * 2);

Time to start our daemon! But before that, we should modify our app.js to
handle SIGTERM.

Add the following to the end of the app.js file:

process.on('SIGTERM', function () {
  if (server === undefined) return;
  server.close(function () {
    // Disconnect from cluster master
    process.disconnect && process.disconnect();

Make the daemon script executable:

$ chmod +x bin/node-simple-http-daemon

And run it (Make sure nothing else is running on port 80):

$ sudo bin/node-simple-http-daemon

Now, your daemon and it's workers should be running in background. You can
confirm that by sending an HTTP GET request via cURL:

$ curl

Before moving to the next step, let's take a look at the process IDs:

$ ps -axf | grep [n]ode-simple-http-daemon | \
  awk '{ print "pid:"$2", parent-pid:"$3 }'

Sample output:

pid:33811, parent-pid:1
pid:33853, parent-pid:33811
pid:33856, parent-pid:33811
pid:33857, parent-pid:33811
pid:33858, parent-pid:33811
pid:33859, parent-pid:33811
pid:33860, parent-pid:33811
pid:33861, parent-pid:33811
pid:33862, parent-pid:33811

Note that the daemon is the process with parent-pid of 1.

Try restarting the workers by sending SIGHUP to the daemon:

$ kill -HUP 33811 # (replace 33811 with the daemon PID)

Now if you list the PIDs again, you should be able to see new worker processes with new PIDs. Amazing, isn't it?

To stop the daemon, just run:

$ kill -TERM 33811 # (replace 33811 with the daemon PID)

Dropping privileges

We're almost done. We only need to make workers drop their privileges after the server gets started.

Modify server.listen() callback in app.js so it reads:

server.listen(PORT, ADDRESS, function () {
    console.log('Server running at http://%s:%d/', ADDRESS, PORT);
    console.log('Press CTRL+C to exit');

    // Check if we are running as root
    if (process.getgid() === 0) {

And that's it for the daemon part.

Now you can install it system-wide:

$ sudo npm link


Making an Upstart job is very easy. Create a file in /etc/init/node-simple-http-daemon.conf with the following contents:
# /etc/init/node-simple-http-daemon.conf

start on started network
stop on stopping network

expect daemon

exec https-proxy-daemon

Now you can:

$ sudo start node-simple-http-daemon # Start the job
$ initctl --system node-simple-http-daemon # Check the job status
$ sudo reload node-simple-http-daemon # Send SIGHUP (restart the workers)
$ sudo stop node-simple-http-daemon # Stop the job

Next Steps

You may want to modify the daemon to give up spawning workers when they're getting killed too frequently (spinning).

I can't emphasize enough how important it is to have adequate logging in your application. Make sure to check out node-bunyan.

Attachments Attachments
There are no attachments for this article.
Related Articles RSS Feed
The Basics of Using the Sed Stream Editor to Manipulate Text in Linux
Viewed 5574 times since Fri, Dec 27, 2013
How To Install And Run A Node.js App On Centos 6.4 64bit
Viewed 9229 times since Sun, Dec 29, 2013
How To Copy Files With Rsync Over SSH
Viewed 5757 times since Fri, Dec 27, 2013
What is FTP and How Is It Used?
Viewed 1643 times since Fri, Dec 27, 2013
How To Set Up a Postfix Email Server with Dovecot: Dynamic Maildirs and LMTP
Viewed 2652 times since Mon, Dec 30, 2013
How To Set Up Apache Virtual Hosts on Ubuntu 12.04 LTS
Viewed 2789 times since Mon, Dec 23, 2013
How To Setup a Rails 4 App With Apache and Passenger on CentOS 6
Viewed 2660 times since Thu, Dec 19, 2013
Geddy.JS: A No-Brainer MVC Node.js Framework
Viewed 2206 times since Sun, Dec 29, 2013
How to Add a Swap File on an Arch Linux Cloud Server
Viewed 1678 times since Fri, Dec 27, 2013