derkades/paper repository overview

Simple docker image for Paper Minecraft server software. I also have a waterfall⁠ image.

⁠Why this image?

• Server is shut down properly when stopping/restarting the container by running the stop command
• Multiarchitecture images
• Using optimized JVM arguments, as recommended by aikar
• EULA-compliant: image does not contain any Mojang code/binaries
• Frequent updates (make sure to docker pull frequently as well!)
• Available for many Minecraft versions
• Using latest java versions for best performance
• Supports running as different users and with a read-only filesystem

⁠Environment variables

• MEM_LIMIT: Server initial and max heap size, by default set to 2G.
• UPGRADE: Set to true to force upgrade all chunks (use when upgrading 1.13->1.14, 1.14->1.15, etc.). Set to false by default.

⁠Tags

Either use the version tag (e.g. 1.16) to always use the latest patch version (auto update from 1.16.1 to 1.16.2, etc.), or use a specific patch version. Pinning to a patch version is recommended to avoid unexpected upgrades. Image updates are only provided for the latest patch version in a release. Older patch versions are eventually removed.

Why these weird eclipse-temurin images? Because openjdk uses oracle linux for newer versions and eclipse-temurin provides support for armv7 and arm64v8 even on older JDK versions.

⁠Example

Check out dockerpanel⁠ for accessing your Minecraft servers through a web interface!

version: '3.2'
services:
  smp:
    image: derkades/paper:1.18
    ports: ['25565:25565']
    volumes: 
      - type: bind
        source: ./data
        target: /data
    tty: true
    stdin_open: true
    stop_grace_period: 60s

⁠Hardened example

version: '3.6'
services:
  smp:
    image: derkades/paper:1.16.5
    ports: ['25565:25565']
    volumes: 
      - type: bind
        source: /srv/minecraft/smp
        target: /data
      - type: tmpfs
        target: /tmp
        tmpfs:
          size: 50M
    tty: true
    stdin_open: true
    stop_grace_period: 60s
    user: '1000'
    read_only: true
    cap_drop: ['ALL']