How To Setup a Node.js Development Environment on a VPS for a Team

PostedOctober 8, 2013 35.4k views Node.js Nginx Ubuntu


In this tutorial, we will setup a Node.js development environment, which allows you to include rapidly new team members into the development process of your Node.js applications. This method can also be applied if a developer wants to create several versions of an application simultaneously.

This method is based on Node.js interacting with Nginx over Unix sockets instead of ports. Let’s assume that you have your development versions of the application at In addition, we will hold the sockets for every developer in the /tmp directory, like /tmp/


You will need to have Nginx and Node.js installed. Additionally, we will assume that you already have a domain (for example linked to your VPS. Note: you should also setup wildcard CNAME record for your domain. There are already well written tutorials about these topics on DigitalOcean:

Setting Up Nginx

We should create a new Nginx configuration file /etc/nginx/sites-available/ which contains:

server {

    listen 80; 

    server_name ~^(?<login>[a-z]+)\.dev\.nodeapp\.com$;

    location / {

        proxy_pass http://unix:/tmp/$$uri$is_args$args;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

Link this configuration to sites-enabled folder and restart Nginx:

ln -nfs /etc/nginx/sites-available/ /etc/nginx/sites-enabled/
/etc/init.d/nginx restart

Now Nginx is ready to accept user requests and guide them to the developer’s app copy, depending on URL. For example: -> /tmp/ -> /tmp/

Modifying Node.js App

We will use a minimal webserver example from the Node.js, but the same modifications can be applicable for any Node.js server (like express).

The thing is, we need to change the default port-listening behavior into socket-listening:

var fs = require('fs');
var http = require('http');

var mask = process.umask(0);
var socket = '/tmp/' + process.env.USER + '';

if (fs.existsSync(socket)) {

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

console.log('Server running at ' + socket);

Now you can run your application node app.js and access it on

Note: when Node.js starts listening for sockets, it creates a specified file. But if the socket file already exists, Node.js will fail to start listening. So we should make sure we remove the socket from the previous run.

The other thing is, we should create a socket with full access for all, so Nginx will be able to use it. It’s fine for development, but might not be good for production.

And that’s it, congratulations! All you need now to introduce a new developer to create user on your VPS.

Submitted by: Artur Burtsev


Creative Commons License