Skip to content

docs-site

Serves the generated MkDocs static output from ../site using NGINX.

Routing is handled by Traefik with host docs.${DOMAIN}.

Deploy flow: 1. Build docs: make docs 2. Start container: make up-docs-site (or make up)

Below are the configuration files for this service. For details on how to deploy or customize, refer to the README above or the official documentation for the service.

Docker Compose Configuration

services:
  docs-site:
    image: nginx:alpine
    container_name: docs-site
    restart: unless-stopped
    volumes:
      - ../site:/usr/share/nginx/html:ro
    networks:
      - web
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.docs-site.entrypoints=websecure"
      - "traefik.http.routers.docs-site.rule=Host(`docs.${DOMAIN}`)"
      - "traefik.http.routers.docs-site.tls=true"
      - "traefik.http.routers.docs-site.tls.certresolver=letsencrypt"
      - "traefik.http.services.docs-site.loadbalancer.server.port=80"

networks:
  web:
    external: true