Maintenance Server

Standalone maintenance server, serving a static "maintenance page" with a default message that the site is under maintenance.

Usage

$ go install git.mills.io/prologic/maintenance-server@latest

Example docker-compose.yml configuration:

version: '3.8'

services:
  fallback:
    image: prologic/maintenance-server
    ports:
      - 8080:8000

Acting as Traefik fallback server

If you serve containers through Traefik and you need to have a proper maintenance page during container cycling, you can attach this image as fallback with lower priority like this:

---
version: "3.8"

services:
  fallback:
    image: prologic/maintenance-server
    networks:
      - traefik
    deploy:
      replicas: 1
      labels:
        - "traefik.enable=true"
        - "traefik.docker.network=traefik"
        - "traefik.http.services.fallback.loadbalancer.server.port=8000"
        - "traefik.http.routers.fallback.rule=HostRegexp(`{catchall:.*}`)"
        - "traefik.http.routers.fallback.priority=1"
      resources:
        reservations:
          cpus: "0.1"
          memory: 16M
        limits:
          cpus: "0.2"
          memory: 32M
      restart_policy:
        condition: on-failure

networks:
  traefik:
    external: true

Other containers will have higher priority, so this one will only be considered if the other one went AWOL.

Licnese

maintenance-server is licsned under the terms of the MIT License (originally forked from @c0b41's also licensed under an MIT License).