Skip to content

lighttpd web server with default config optimized for high traffic frontend website

License

Notifications You must be signed in to change notification settings

rtsp/docker-lighttpd

Repository files navigation

lighttpd Docker Image

  • lighttpd is a secure, fast, compliant, and very flexible web-server that has been optimized for high-performance environments
  • docker-lighttpd is a lighttpd docker image designed to use as base image for building frontend/static web app docker image (e.g. React)

Base Image

  • Use docker-lighttpd as a base image (FROM) and copy your web artifacts to /var/www/html
  • Optimized for serving high traffic frontend/static web app

Useful Info

Paths

  • /var/www/html - Document root
  • /etc/lighttpd/lighttpd.conf - Entry point of to include configs from conf.d/*.conf
  • /etc/lighttpd/conf.d/
    • 00-mime-types.conf - MIME types definition derived from NGINX /etc/nginx/mime.types
    • 01-server.conf 05-webroot.conf 11-access.conf - Configs derived from the default lighttpd.conf
    • 12-expire.conf 13-status.conf 14-rewrite.conf - Example configs for several use cases

Feel free to replace or modify these config files if required!

Default Config (lighttpd.conf)

  • Run as lighttpd user
  • Listen on port 80
  • No SSL/HTTPS (designed to run behind load balancer or reverse proxy server)
  • No log file writing
  • No Cache-Control header

Examples

Dockerize React App (Multi-Stage Build)

FROM node:14 AS builder

COPY package.json \
     package-lock.json \
     /usr/web/

WORKDIR /usr/web/
RUN npm ci

COPY public/ /usr/web/public/
COPY src/ /usr/web/src/
RUN npm run build

FROM rtsp/lighttpd
COPY --from=builder /usr/web/build/ /var/www/html/

Directly use as Web Server (Volume mount)

docker run -d \
  --name your-webapp \
  -v /webapp/dir:/var/www/html:ro \
  -p 8080:80 \
  rtsp/lighttpd
  • Mount /webapp/dir as your web app document root
  • Publish website to port 8080 of Docker host machine.
  • Enter http://localhost:8080

Links