Dockerfile for Docusaurus

Serve static documentation Docusaurus website via Nginx
By: Dániel Sipos on

My first encounter with Docusaurus was in 2020! Although I had encountered it before in all kinds of code documentation environments, I did not know that those websites were made with this tool.

In the first round, I tried with my own micro frontend framework SUI-JS how I can create a documentation website using static markdown articles from the documented code.

Nginx - default.conf

server {
    listen       80;
    listen  [::]:80;
    server_name  localhost;

    #access_log  /var/log/nginx/host.access.log  main;

    root /usr/share/nginx/html;

    location / {
        try_files $uri $uri.html /index.html =404;

    # redirect server error pages to the static page /50x.html
    error_page   500 502 503 504  /50x.html;
    location = /50x.html {
        root   /usr/share/nginx/html;


FROM node:16 as builder

RUN npm install -g npm@8.18.0

# Install dependencies
COPY package.json package-lock.json ./
RUN npm ci

# Copy all local files into the image
COPY . .

RUN npm run build

FROM nginx:1.23-alpine as runner

ENV INSTALL_PATH /usr/share/nginx/html


COPY default.conf /etc/nginx/conf.d
COPY --from=builder /app/build/ $INSTALL_PATH/

RUN set -x ; 
  addgroup -g 82 -S www-data ; 
  adduser -u 82 -D -S -G www-data www-data && exit 0 ; exit 1

RUN chown -R www-data:www-data $INSTALL_PATH/*
RUN chmod -R 0755 $INSTALL_PATH/*


Finally, It is a simple solution to have a part of a CI/CD process. Docker build produce a small-sized nginx image.

Share with your friends

Related posts