responsible code hotswap for zero downtime deploys

npm install liveswap
22 downloads in the last week
33 downloads in the last month



Safe code hotswap for zero downtime re-deploys.


An application in production should not need to be stopped in order to utilize new code.


liveswap is a library that helps you update an application’s code without stopping it. It also ships with a command-line tool and it doesn’t impose any special requirements or conventions on your application code.

It works by creating a light-weight master process that runs your application code as worker processes. It then starts listening for instructions.

When you send an upgrade instruction, workers take turns disconnecting their underlying servers. When a server is disconnected, it lets the old connections finish up, but no new connections are accepted. When all of the worker’s connections have been closed, it will be retired and a new one will be created using the new code. For more in depth information read this blog post.



npm install liveswap -g


Using the node.js hello world example, in a filed named index1.js...

First Version (Sample Code)

var http = require('http')
http.createServer(function (req, res) {
  res.writeHead(200, {'Content-Type': 'text/plain'})
  res.end('Hello World\n')
}).listen(1337, '')
console.log('Server running at')


Start the application using liveswap from the command-line...

liveswap -s index1.js

Alternatively, start liveswap programmatically...

var liveswap = require('liveswap')

Second Version (Sample Code)

Now we have an updated version of the code in index2.js...

var http = require('http')
http.createServer(function (req, res) {
  res.writeHead(404, {'Content-Type': 'text/plain'})
  res.end('Not Found\n')
}).listen(1337, '')
console.log('Server running at')

Live Update

Update the current code by sending an update command to the server.

liveswap -u ./index2.js

After sending an update message the worker processes will wait for any current connections to end before restarting with the new code.

CLI Options

  -p, --port     <port> specify the source code to upgrade to.                 [default: 3000]
  -a, --address  <address> specify the ip address to run on.                   [default: ""]
  -f, --forks    <number> specify how many worker processes to spawn           [default: 2]
  -u, --upgrade  <path> specify the source code to upgrade to.
  --pre-upgrade  <path> a module to handle pre upgrade logic.
  -k, --kill     kill all forked worker processes and respawn.
  -d, --die      kill all forked worker processes and quit master process.
  -m, --message  <message> send a message to all the forked worker processes.
  -s, --start    <path> start a node process cluster.

Pre-upgrade allows you to require a module that will be executed before each time the upgrade happens.

liveswap --pre-upgrade ./pull.js --start ./index1.js



The main export of this library accepts an options object or a string. If a string is specified, it will be interpreted as the target option.

[option] { target: <String> }

[option] { port: <Number> }

[option] { forks: <Number> }

[option] { "pre-ugrade": <String> }

  port: 9008,
  forks: 2,
  target: './index.js'
  "pre-upgrade": './pull.js'
npm loves you