/minecraft-paper-docker

Automatic Docker builds for Minecraft Paper server

Primary LanguageDart

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

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