How to Deploy Next.js Standalone with Prisma Using Docker in your VPS

Introduction

Deploying a Next.js application in standalone mode with Prisma using Docker can enhance performance and simplify management. This guide will walk you through creating an optimized Dockerfile for building and deploying your Next.js application.

Prerequisites

Before starting, make sure you have installed:

• Node.js
• Docker
• Prisma
• Next.js

Configuring Next.js for Standalone Mode

Before building the Docker image, configure Next.js to run in standalone mode by adding the following settings in next.config.js:

This configuration ensures that Next.js generates a standalone output, making it run more efficiently inside a container.

Dockerfile for Next.js Standalone with Prisma

Here is the Dockerfile using a multi-stage build for a lightweight and efficient deployment:

Dockerfile Explanation

1. Base Stage (base)

• Uses node:18-alpine3.20 as the lightweight base image.
• Installs libc6-compat for additional compatibility.

2. Dependencies Stage (deps)

• Copies package.json and lock files (yarn.lock, package-lock.json, pnpm-lock.yaml).
• Installs dependencies based on the available lock file.
• Copies the prisma/ directory to ensure Prisma is included.

3. Build Stage (builder)

• Copies dependencies from the deps stage to avoid reinstalling them.
• Copies the entire project code and builds the Next.js application.

4. Production Stage (runner)

• Runs the application as a non-root user (nextjs) for security.
• Copies the build output (.next/standalone and .next/static).
• Copies Prisma files and .env to ensure database connectivity.
• Exposes port 3000 and runs the application using node server.js.

Running the Application in Docker

Once the Dockerfile is ready, build and run the container using the following commands:

Conclusion

Using a multi-stage build approach optimizes Docker image size and efficiency for Next.js with Prisma. By following these steps, your application will be ready for deployment with improved performance in a production environment.