josxha/minecraft-paper repository overview

⁠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
• Support for amd64 and arm64

⁠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.1
        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

1. (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
2. Run docker-compose up -d in the directory of your docker-compose.yml file.
3. (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.1, 1.18, 1.17.1, etc. for the latest paper build of this minecraft version
• minecraftVersion-paperBuild to use specific paper build

See all the available tag here⁠.