Node.js and Docker. If you haven't spent the last decade in an underwater cave playing solitaire on a coral bed, you must have at least heard of these two ever-trending techs in the web development industry. In this article we'll show you how to create a Docker image for an application written in Node.js.

Why should I dockerize my application

You might've heard about the whole Docker thing, but that still doesn't answer the question: "why bother?" Well, here's why:

  • You can launch a fully capable development environment on any computer supporting Docker; you don't have to install libraries, dependencies, download packages, mess with config files etc.
  • The working environment of the application remains consistent across the whole workflow. This means the app runs exactly the same for developer, tester, and client, be it on development, staging or production server.

In short, Docker is the counter-measure for the age-old response in the software development: "Strange, it works for me!"

Part 1: Creating Node.js application

If you know the basics of Node.js, you can skip this part and proceed directly to the Docker part.

We'll start off with creating a simple Hello World website, an obvious guest to every web developer's portfolio.

Install Node.js

If you've never worked with Node.js before, kick off with installing the npm manager:

Install NPM and Express Framework

In addition to npm, our application will use the Express Framework, one of the most popular Node.js frameworks. Create a new directory and initialize npm:

$ mkdir helloworld
$ cd helloworld
$ npm init

When asked for the details of the application (name, version, etc.), just confirm the default values with enter.

Npm will create a package.json that will hold the dependencies of the app. Let's add the Express Framework as the first dependency:

$ npm install express --save

The file should look like this now:

  "name": "helloworld",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  "author": "",
  "license": "ISC",
  "dependencies": {
    "express": "^4.15.2"

TableMain of Hello World

With everything installed, we can create an index.js file with a simple HTTP server that will serve our Hello World website:

//Load express module with `require` directive
var express = require('express')
var app = express()

//Define request response in root URL (/)
app.get('/', function (req, res) {
  res.send('Hello World!')

//Launch listening server on port 8081
app.listen(8081, function () {
  console.log('app listening on port 8081!')

Run the app

The application is ready to launch:

$ node index.js

Go to http://localhost:8081/ in your browser to view it.

Part 2: Dockerizing Node.js application

Every application requires a specific working environment: pre-installed applications, dependencies, data bases, everything in specific version. Docker containers allow you to create such environments. Contrary to VM, however, the container doesn't hold the whole operating system—just applications, dependencies, and configuration. This makes Docker containers much lighter and faster than regular VM's.

In this part of the guide, we shall launch the previously created app in a Docker container.

If you skipped the first part of the guide, you can fork the repository with the already created Node.js application here:

Install Docker

Begin with installing Docker for your type of OS:

Write Dockerfile

The Docker container is launched on the basis of a Docker image, a template with the application details. The Docker image is created with instructions written in the Dockerfile. Let's add Dockerfile to the directory with our application:

Line 1: Use another Docker image for the template of my image. We shall use the official Node.js image with Node v7.

You can share images using image registries. In this example we'll use Docker Hub, the most popular one.

FROM node:7

Line 2: Set working dir in the container to /app. We shall use this directory to store files, run npm, and launch our application:


Line 3-5: Copy application to /app directory and install dependencies. If you add the package.json first and run npm install later, Docker won't have to install the dependencies again if you change the package.json file. This results from the way the Docker image is being built (layers and cache), and this is what we should do:

COPY package.json /app
RUN npm install
COPY . /app

Line 6: This line describes what should be executed when the Docker image is launching. What we want to do is to run our application:

CMD node index.js

Line 7: Expose port 8081 to the outside once the container has launched:


Summing up, the whole Dockerfile should look like this:

FROM node:7
COPY package.json /app
RUN npm install
COPY . /app
CMD node index.js

Build Docker image

With the instructions ready all that remains is to run the docker build command, set the name of our image with -t parameter, and choose the directory with the Dockerfile:

$ docker build -t hello-world .

Run Docker container

The application has been baked into the image. Dinner time! Execute the following string to launch the container and publish it on the host with the same port 8081:

docker run -p 8081:8081 hello-world

Sharing Docker image

Docker images can be hosted and shared in special image registries. The most popular is Docker Hub, a GitHub among Docker registries, in which you can host private and public images. Let's push an image to Docker Hub now:

  1. Sign up at
  2. Build the image again using your Docker Hub credentials:

     $ docker build -t [USERNAME]/hello-world .
  3. Log in to Docker Hub with your credentials:

     $ docker login

    Logging in to Docker HubLogging in to Docker Hub

  4. Push the image to Docker Hub:

     $ docker push [USERNAME]/hello-world

    Docker image on Docker HubDocker image on Docker Hub

Congratulations! You can now use the image on any server or PC with Docker installed:

$ docker run [USERNAME]/hello-world

Please mind the image needs to be downloaded on the first run which may take some time depending on your connection.

Dockerize your Node.js app with Buddy

Deploying dockerized application to server

Running a dockerized app requires a couple of steps:

  1. Test if the application is free of errors
  2. Build the Docker image
  3. Pushing the image to the registry
  4. Pull and run the image on the server

The steps are very simple, but very time-consuming. Instead, it's possible to configure everything to be executed step by step on a single push to the repository. And this is what Buddy does: