Skip to content

🐳 Docker PaperMC Server

A general-purpose, OCI-compliant PaperMC server with streamlined and fine-grained customization options.

💻 Demonstration (12 seconds)

✨ Highlights

  • 🏔️ Alpine-based image
  • 🪶 Lightweight – ~125 MB
  • 🧘 Minimalist – Includes only essential dependencies to reduce image size and surface area
  • 🧩 Customizable – Streamlined and fine-grained configuration options (WIP)
  • 👤 UID-agnostic – Supports running the server with a custom/arbitrary UID (typically required when running container in OpenShift)
  • 🔐 Rootless by default – Runs as a non-root user when no custom UID is specified
  • 🧬 Multi-architecture support – Built for linux/amd64 & linux/arm64 (additional OSs/architectures available on request)
  • ☕ JRE 21 – Based on Eclipse Temurin
  • Custom-built using jlink to minimize size
  • Includes standard Java modules for broad plugin compatibility
  • 🩺 Healthcheck integration – Enhances resilience and high availability by continuously monitoring server health
  • 🔍 Frequent quality & security scans – Powered by SonarQube Cloud and Docker Scout
  • 🔄 Scheduled auto-updates – Bi-monthly rebuilds to incorporate upstream security patches and new PaperMC builds. Other updates are tracked and semi-automatically managed via Renovate.
  • ☸️ Helm Chart – Easily deploy the server to Kubernetes using the reference Helm Chart.