Docker deployment in NextJS

Introduction

Docker deployment helps you package your Next.js app with everything it needs to run. This makes it easy to share and run your app anywhere without setup problems.

You want to share your Next.js app with others who may have different computers.

You want to run your app on a cloud server or hosting service that supports Docker.

You want to keep your app environment consistent between your computer and production.

You want to easily update or roll back your app versions.

You want to isolate your app from other software on the same machine.

Syntax

NextJS

FROM node:18-alpine
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

FROM sets the base image with Node.js installed.

WORKDIR sets the folder inside the container where commands run.

Examples

This Dockerfile builds a Next.js app using Node 18 on Alpine Linux. It installs dependencies, builds the app, and starts it on port 3000.

NextJS

FROM node:18-alpine
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

This variation uses npm ci for clean install and copies all files at once.

NextJS

FROM node:18-alpine
WORKDIR /app
COPY . .
RUN npm ci
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

Sample Program

This Dockerfile sets up a container for a Next.js app. It uses Node 18 Alpine image for a small size. It copies package files first to install dependencies, then copies the rest of the app code. It builds the app and exposes port 3000. Finally, it starts the app with npm start.

NextJS

/* Dockerfile */
FROM node:18-alpine
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm install
COPY . .
RUN npm run build
EXPOSE 3000
CMD ["npm", "start"]

Important Notes

Always copy package.json and package-lock.json first to use Docker cache for faster builds.

Use EXPOSE 3000 to tell Docker which port your app listens on.

Run docker build -t my-next-app . to build and docker run -p 3000:3000 my-next-app to start the container.

Summary

Docker deployment packages your Next.js app with all needed parts.

It makes your app easy to run anywhere with the same environment.

Use a Dockerfile to define how to build and run your app container.