DEV Community


Posted on • Updated on

Creating dockerized NextJS Application

Table of content:

Hello everyone.

I assume that you already have Docker, NodeJS and YARN installed.

Create NextJS app

To create a new Nextjs app execute yarn create next-app app-name or you can pick an example app from there and create a new app with supplied command.

I'm going to pick blog starter example.
In the How to use section copy command

yarn create next-app --example blog-starter-typescript blog-starter-typescript-app
Enter fullscreen mode Exit fullscreen mode

paste it in your terminal and hit enter.

Dockerize NextJS app

Open this awesome post and copy the final version of docker configuration.

Inside the root folder of your project (where package.json file is) create a new file named Dockerfile, paste copied configuration into it.

We need to tweak it a little (otherwise AWS will complain - try out yourself without deleting if you're curious):

  1. delete image aliases (AS %alias_name% part of FROM statement)
  2. replace used aliases with image indices (--from=deps becomes --from=0 and --from=BUILD_IMAGE becomes --from=1)

Our final Dockerfile:

# dependencies image
FROM node:14-alpine
COPY package.json yarn.lock ./
RUN yarn install --frozen-lockfile

# build image
FROM node:14-alpine
COPY --from=0 /app/node_modules ./node_modules
COPY . .
RUN yarn build
RUN rm -rf node_modules
RUN yarn install --production --frozen-lockfile --ignore-scripts --prefer-offline

# build output image
FROM node:14-alpine

ENV NODE_ENV production

RUN addgroup -g 1001 -S nodejs
RUN adduser -S nextjs -u 1001
COPY --from=1 --chown=nextjs:nodejs /app/package.json /app/yarn.lock ./
COPY --from=1 --chown=nextjs:nodejs /app/node_modules ./node_modules
COPY --from=1 --chown=nextjs:nodejs /app/public ./public
COPY --from=1 --chown=nextjs:nodejs /app/.next ./.next

USER nextjs


CMD [ "yarn", "start" ]
Enter fullscreen mode Exit fullscreen mode

Also create .dockerignore file near Dockerfile and insert two directory names into it:

Enter fullscreen mode Exit fullscreen mode

To make sure it works run the following commands:

  • docker build -t example-nextjs-app . - builds our image
  • docker run -p 3000:3000 example-nextjs-app - runs our image

Now open localhost:3000 in your browser - you should see your app up and running. Yay =)

To stop docker image either kill (close) the terminal or stop the image:

  1. execute command docker ps
  2. copy container id
  3. execute command docker stop container id

In the next part we are going to deploy our application to AWS Elastic Beanstalk. Hope to see you in the =)

Thanks for reading.

Top comments (2)

anshusaurav profile image
Anshu Saurabh


I am not able to access Can you suggest some alternative link to similar dockerfile

bnn1 profile image

Hello. Thank you for your comment :) Please refer to this repo:
it has the most up to date docker configuration for dockerizing a next.js app