{"id":26512972,"url":"https://github.com/djaytan/docker-papermc-server","last_synced_at":"2026-02-15T18:09:14.541Z","repository":{"id":281737111,"uuid":"946260314","full_name":"Djaytan/docker-papermc-server","owner":"Djaytan","description":"Dockerized and fine-grained customizable PaperMC server","archived":false,"fork":false,"pushed_at":"2025-03-19T22:00:03.000Z","size":19,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T22:37:52.775Z","etag":null,"topics":["cloud","container","docker","image","oci","papermc","server"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Djaytan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-10T21:34:56.000Z","updated_at":"2025-03-19T22:00:06.000Z","dependencies_parsed_at":null,"dependency_job_id":"bb69830a-bbac-44bd-8c00-22061e3fc7b3","html_url":"https://github.com/Djaytan/docker-papermc-server","commit_stats":null,"previous_names":["djaytan/docker-papermc-server"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djaytan%2Fdocker-papermc-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djaytan%2Fdocker-papermc-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djaytan%2Fdocker-papermc-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Djaytan%2Fdocker-papermc-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Djaytan","download_url":"https://codeload.github.com/Djaytan/docker-papermc-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244734196,"owners_count":20501018,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud","container","docker","image","oci","papermc","server"],"created_at":"2025-03-21T04:19:16.146Z","updated_at":"2026-02-15T18:09:14.536Z","avatar_url":"https://github.com/Djaytan.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e🐳 Docker PaperMC Server\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n![Compatibility](https://img.shields.io/badge/PaperMC_Support-v1.21.4-blue)\n[![CI](https://github.com/Djaytan/docker-papermc-server/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/Djaytan/docker-papermc-server/actions/workflows/ci.yml)\n[![semantic-release: conventional-commits](https://img.shields.io/badge/semantic--release-conventional--commits-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)\u003cbr/\u003e\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Djaytan_docker-papermc-server\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Djaytan_docker-papermc-server)\n[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/10360/badge)](https://www.bestpractices.dev/projects/10360)\n[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/Djaytan/docker-papermc-server/badge)](https://securityscorecards.dev/viewer/?uri=github.com/Djaytan/docker-papermc-server)\u003cbr/\u003e\n[![Docker Pulls](https://img.shields.io/docker/pulls/djaytan/papermc-server.svg?logo=docker)](https://hub.docker.com/r/djaytan/papermc-server/)\n\nA general-purpose, OCI-compliant PaperMC server with streamlined and fine-grained customization options.\n\nAvailable in [Docker Hub](https://hub.docker.com/r/djaytan/papermc-server).\n\n\u003c/div\u003e\n\n## 💻 Demonstration (20 seconds)\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://asciinema.org/a/725450?autoplay=1\" target=\"_blank\"\u003e\u003cimg src=\"https://github.com/Djaytan/docker-papermc-server/blob/main/docs/asciinema/demo.gif\" alt=\"asciicast\"\u003e\u003c/a\u003e\n\u003c/div\u003e\n\n## 📘 Usage\n\nFor a quick start, you can run the following command:\n\n```bash\n$ docker run -d -it \\\n    --name papermc-server \\\n    --restart=always \\\n    -p 25565:25565 \\\n    -e EULA=true \\\n    'djaytan/papermc-server:latest'\n```\n\n\u003e [!NOTE]\n\u003e Available tags can be found [here](https://hub.docker.com/r/djaytan/papermc-server/tags).\n\n\u003e [!IMPORTANT]\n\u003e Setting the `EULA` environment variable to `true` implies that you have read and accepted the [Minecraft EULA](https://www.minecraft.net/en-us/eula).\n\n\u003e [!TIP]\n\u003e For detailed instructions on running the server, including configuration options and best practices, check out\n\u003e the [user guide](https://djaytan.github.io/docker-papermc-server/).\n\n## ✨ Highlights\n\n* 🏔️ **[Alpine](https://hub.docker.com/_/alpine)-based image**\n* 🪶 **Lightweight** – ~125 MB\n* 🧘 **Minimalist** – Includes only essential dependencies to reduce image size and surface area.\n* 🧩 **Customizable** – Streamlined and fine-grained configuration options.\n* 📚 **Well-documented** – Comprehensive and structured documentation covering features, configuration, and\n  usage ([link](https://djaytan.github.io/docker-papermc-server/)).\n* 👤 **UID-agnostic** – Supports running the server with a custom/arbitrary UID (typically required when running container\n  in [OpenShift](https://www.redhat.com/en/technologies/cloud-computing/openshift)).\n* 🔐 **Rootless by default** – Runs as a non-root user when no custom UID is specified.\n* 🧬 **Multi-architecture support** – Built for `linux/amd64` \u0026 `linux/arm64` _(additional OSs/architectures available on request)_.\n* ☕ **JRE 21** – Based on [Eclipse Temurin](https://hub.docker.com/_/eclipse-temurin).\n  * Custom-built using `jlink` to minimize size.\n  * Includes standard Java modules for broad plugin compatibility.\n* 🩺 **Healthcheck integration** – Enhances resilience and high availability by continuously monitoring server health.\n* 🔍 **Frequent quality \u0026 security scans** – Powered by [SonarQube Cloud](https://sonarcloud.io/summary/new_code?id=Djaytan_docker-papermc-server)\n  and [Docker Scout](https://docs.docker.com/scout/).\n* 🔄 **Scheduled auto-updates** – Bi-monthly rebuilds to incorporate upstream security patches and new PaperMC builds. Other updates are tracked and\n  semi-automatically managed via Renovate.\n* ☸️ **Helm Chart** – Easily deploy the server to Kubernetes using [the reference Helm Chart](https://github.com/Djaytan/helm-papermc-server).\n\n## 🌍 Contributing\n\nIf you want to help us improve the project, you can learn more about ways to do so [here](docs/CONTRIBUTING.md).\n\nHave a feature request? Don't hesitate to [fill an issue](https://github.com/Djaytan/docker-papermc-server/issues)!\n\n## 🏷️ Versioning\n\nThis project follows [Semantic Versioning](https://semver.org/).\n\nThe Docker tagging scheme is `\u003cmc-version\u003e-v\u003cimage-version\u003e-\u003ctimestamp-YYYYMMDD\u003e` (e.g. `1.21.4-v1.2.1-20250406`)\n\n## 🔒 Security Policy\n\nIn case you think having found a security vulnerability, please consult\nour [Security Policy](docs/SECURITY.md).\n\n## 📄 Licence\n\nThis project inherits its licensing from the included upstream projects. As such, it is licensed under\nthe [GNU GPL v3.0](https://www.gnu.org/licenses/gpl-3.0.html) license, as it inherits from PaperMC, which in turn inherits it from the original Bukkit and\nCraftBukkit projects.\n\nThe distributed OCI image is based on [the Alpine one](https://hub.docker.com/_/alpine).\nAs with all Docker images, these likely also contain other software which may be under other licenses. Details about Alpine packages can be\nfound [here](https://pkgs.alpinelinux.org/packages).\n\nAs for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with\nany relevant licenses for all software contained within.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjaytan%2Fdocker-papermc-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjaytan%2Fdocker-papermc-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjaytan%2Fdocker-papermc-server/lists"}