Automatic Docker builds for Paper Minecraft

This repository checks automatically every hour for new paper server builds, builds new images with them and uploads them to the docker registry.

Links

• Images: hub.docker.com/r/josxha/minecraft-paper
• Repository: github.com/josxha/minecraft-paper-docker
• Papermc: papermc.io/downloads

Why to use this image

• Easy to use and configure
• Up to date with the latest paper builds
• Much smaller image size compared to other paper images
• Open source repository

Get Started

1. Install docker (docker docs)
2. Install docker-compose (docker docs)
3. Example content of your docker-compose.yml file:

version: '3'
services:
    minecraft:
        image: josxha/minecraft-paper:latest # or e.g. 1.18.2
        container_name: minecraft
        restart: unless-stopped
        ports:
            - 0.0.0.0:25565:25565
        volumes:
            - ./data:/data:rw
        # user: 25565:25565
        environment:
            - TZ=Europe/London
            - RAM=4G

4. (optional) If you want to run the container not as root
   1. uncomment the line user: 25565:25565
   2. create the data directory with mkdir ./data
   3. change the directory permissions with sudo chown 25565:25565 ./data
5. Run docker-compose up -d in the directory of your docker-compose.yml file.
6. (optional) Use watchtower to keep your container up to date with the latest image build automatically.

Image Tags

• latest: Newest minecraft version with the latest paper build
• 1.18-latest, 1.17-latest, etc. for the latest paper build of this major minecraft version
• 1.18.2, 1.18, 1.17.1, etc. for the latest paper build of this minecraft version
• <minecraft_version>-<paper_build> to use specific paper build

See all the available tag here.