Overview
What is dockerized-mcpaper-server?
dockerized-mcpaper-server automates creating a Minecraft server using a simple, reproducible, and transportable Docker container. It is configured around the PaperMC server software and intended for users who want an isolated, containerized Minecraft server.
How to use dockerized-mcpaper-server?
Set OUT_PORT, SERVER_JAR_URL, and DEDICATED_RAM in docker-compose.yml, then run docker compose up -d from the base folder. Attach to the server console with docker attach <container_name>, detach with CTRL+P+Q, and stop with docker compose down.
Key features of dockerized-mcpaper-server
- Full PaperMC server inside a Docker container
- Only three required inputs: port, JAR URL, RAM
- Persistent data stored in
./volumes/server - Easy console attach and detach via Docker
- Supports custom volume mounts for extra persistence
- Simple rebuild with
docker compose up --build
Use cases of dockerized-mcpaper-server
- Quickly spin up a PaperMC Minecraft server without manual setup
- Reproducible server deployment across different machines
- Isolated server environment with persistent world data
- Easy server management using Docker Compose commands
FAQ from dockerized-mcpaper-server
What are the required environment variables?
OUT_PORT (the server port), SERVER_JAR_URL (download URL for the PaperMC jar), and DEDICATED_RAM (memory allocation for the server).
How do I start the server?
Set the three required variables in docker-compose.yml, then run docker compose up -d from the base folder.
How do I attach to the server console?
Run docker attach <container_name>. To detach without stopping the server, press CTRL+P+Q inside the terminal window.
How do I persist additional folders?
Add a bind mount entry in the volumes section of docker-compose.yml, specifying the host source path and the container target path (e.g., for world backups).
How do I rebuild the image after Dockerfile changes?
Run docker compose up --build. Persistent data will not be deleted when rebuilding; you must manually delete the persisted folders to remove them.
