The Node.js Docker image used by Google App Engine Flexible.
Clone or download
sharifelgamal Update default nodejs version to 10.14.2 (#189)
* bump default node version to 10.14.1

* Update default nodejs version to 10.14.2
Latest commit 7cd0931 Dec 12, 2018

Google Cloud Platform Node.js Docker Image

Build Status

This repository contains the source for the Google-maintained Node.js docker image. This image can be found at or and can be used as the base image for running applications on Google App Engine Flexible, Google Kubernetes Engine, or any other Docker host.

This image is based on Ubuntu 16.0.4 and includes nodejs and npm installed from and yarn installed from

For a more thorough walk through of getting started with Node.js on Google Cloud Platform, please see the documentation and guides.

App Engine

To generate a Dockerfile that uses this image as a base, use the Cloud SDK. From your existing Node.js application:

gcloud beta app gen-config --custom

You can then modify the Dockerfile and .dockerignore as needed for you application.

Kubernetes Engine and Other Docker Hosts

For other docker hosts, you'll need to create a Dockerfile based on this image that copies your application code and installs dependencies. For example:


# Copy application code.
COPY . /app/

# Install dependencies.
RUN npm --unsafe-perm install

By default, the CMD is set to npm start. You can change this by specifying your own CMD or ENTRYPOINT.

For a full example on deploying an application to Google Kubernetes Engine, see this tutorial.

Kubernetes Configuration

This image assumes your application listens on port 8080. To run an application based on this image inside a Kubernetes pod, you can use a Pod configuration like this:

kind: Pod
  name: app
  namespace: default
  - image: $IMAGE_NAME
    imagePullPolicy: IfNotPresent
    name: app
    - containerPort: 8080
  restartPolicy: Always

Installing a Different Node.js Version

The image includes the install_node script that can be used to install a particular Node.js version. For example:


# Install node.js 4.6.1
RUN install_node v4.6.1

# Copy application code.
COPY . /app/

# Install dependencies.
RUN npm --unsafe-perm install

Node.js is installed with binary packages hosted on a Google-provided mirror. Before installing the specified version of Node.js, checks are performed to verify that the associated binary is an official Node.js release. The install_node script will refuse to install a binary that fails this verification.

To override this behavior, and force the installation of the binary, pass the --ignore-verification-failure flag to install_node. However, it is highly recommended that you only install Node.js binaries that have been successfully verified.

Contributing changes