thurcombe/project_zomboid repository overview

⁠Project Zomboid Dedicated Server

A lightweight, rootless Project Zomboid dedicated server image built via SteamCMD.

⁠Features

• Multi-stage build — SteamCMD fetches server files in a builder stage; the final image contains only the runtime
• Non-root — runs as gameserver (UID 1001)
• Graceful shutdown — wrapper script sends quit to the server on SIGTERM/SIGINT and waits up to 120s for a clean save
• Signal handling — uses tini⁠ as PID 1 for correct signal forwarding
• Weekly rebuilds — CI rebuilds every Sunday to pick up base image and game updates

⁠Quick Start

services:
  pz:
    image: thurcombe/project_zomboid:latest
    container_name: pz
    environment:
      SERVER_NAME: "myserver"
      ADMIN_PASSWORD: "changeme"
    ports:
      - "16261:16261/udp"
      - "16262:16262/udp"
    volumes:
      - ./gamedata:/home/gameserver/Zomboid