{"id":14969703,"url":"https://github.com/felixklauke/paper-docker","last_synced_at":"2025-10-26T09:30:54.159Z","repository":{"id":33079743,"uuid":"149954137","full_name":"felixklauke/paper-docker","owner":"felixklauke","description":"PaperSpigot Docker. Easy to use and clean docker image for running paper spigot servers in docker containers using OpenJDK. WIP","archived":false,"fork":false,"pushed_at":"2022-06-21T06:06:59.000Z","size":104,"stargazers_count":55,"open_issues_count":6,"forks_count":28,"subscribers_count":7,"default_branch":"dev","last_synced_at":"2025-01-31T17:40:35.842Z","etag":null,"topics":["bukkit","container","containerized","craftbukkit","docker","docker-container","docker-image","docker-images","docker-paperspigot","dockerized","dockerized-paperspigot","dockerized-spigot","minecraft","minecraft-docker","paper","paperspigot","paperspigot-docker","spigot","spigot-container","spigot-docker"],"latest_commit_sha":null,"homepage":"https://www.felix-klauke.com","language":"Dockerfile","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/felixklauke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-23T06:31:05.000Z","updated_at":"2024-07-30T18:12:48.000Z","dependencies_parsed_at":"2022-07-16T05:00:38.150Z","dependency_job_id":null,"html_url":"https://github.com/felixklauke/paper-docker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixklauke%2Fpaper-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixklauke%2Fpaper-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixklauke%2Fpaper-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/felixklauke%2Fpaper-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/felixklauke","download_url":"https://codeload.github.com/felixklauke/paper-docker/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238301211,"owners_count":19449403,"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":["bukkit","container","containerized","craftbukkit","docker","docker-container","docker-image","docker-images","docker-paperspigot","dockerized","dockerized-paperspigot","dockerized-spigot","minecraft","minecraft-docker","paper","paperspigot","paperspigot-docker","spigot","spigot-container","spigot-docker"],"created_at":"2024-09-24T13:42:14.679Z","updated_at":"2025-10-26T09:30:53.819Z","avatar_url":"https://github.com/felixklauke.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# paperspigot-docker\nEasy to use and clean Docker image for running Paper Spigot servers in Docker containers using OpenJDK. \n\nYou may also be interested in [waterfall-docker](https://github.com/FelixKlauke/waterfall-docker) and [velocity-docker](https://github.com/FelixKlauke/velocity-docker) if you want to build a whole server network.\n\n# Getting started\nThe easiest way for a quick start would be:\n```bash\ndocker run -it \\\n    -p 25565:25565 \\\n    -v ~/minecraft/config:/opt/minecraft/config \\\n    -v ~/minecraft/worlds:/opt/minecraft/worlds \\\n    -v ~/minecraft/plugins:/opt/minecraft/plugins \\\n    -v ~/minecraft/data:/opt/minecraft/data \\\n    -v ~/minecraft/logs:/opt/minecraft/logs \\\n    felixklauke/paperspigot:1.16.5\n```\n\n# Tags and Versions\nThe Docker images are tagged for their Minecraft versions. These versions are currently available:\n- `felixklauke/paperspigot:1.16.5`\n- `felixklauke/paperspigot:1.16.4`\n- `felixklauke/paperspigot:1.16.3`\n- `felixklauke/paperspigot:1.16.2`\n- `felixklauke/paperspigot:1.16.1` \n- `felixklauke/paperspigot:1.15.2` \n- `felixklauke/paperspigot:1.15.1` \n- `felixklauke/paperspigot:1.15` \n- `felixklauke/paperspigot:1.14.4` \n- `felixklauke/paperspigot:1.14.3` \n- `felixklauke/paperspigot:1.14.2` \n- `felixklauke/paperspigot:1.14.1` \n- `felixklauke/paperspigot:1.14`\n- `felixklauke/paperspigot:1.13.2` \n- `felixklauke/paperspigot:1.13.1`\n- `felixklauke/paperspigot:1.13`\n- `felixklauke/paperspigot:1.12.2`\n- `felixklauke/paperspigot:1.12.1`\n- `felixklauke/paperspigot:1.12`\n- `felixklauke/paperspigot:1.11.2`\n- `felixklauke/paperspigot:1.10.2`\n- `felixklauke/paperspigot:1.9.4`\n- `felixklauke/paperspigot:1.8.8`\n\nThe specific images are updated by hand. The 1.x-latest images will update at nightly builds and will always\nuse the latest build.\n\n# Volumes\nThere are five volumes which are used for:\n- Worlds\n- Plugins\n- Config files (paper.yml, bukkit.yml, spigot.yml, server.properties, commands.yml)\n- Data (banned-ips.json, banned-players.json, help.yml, ops.json, permissions.yml, whitelist.json)\n- Logs\n\nYou can find the mount locations in `docker-compose.yml`.\n\n# docker-compose.yml\n## Bind Mounts\nThis method is recommended if you have an already existing server which you wish to run inside a container [due to\nthe way bind mounts behave.](https://docs.docker.com/storage/bind-mounts/#mount-into-a-non-empty-directory-on-the-container)\nYou can add this simple entry to your docker-compose.yml when using bind mounts:\n```yaml\nversion: '3.7'\n\nservices:\n  minecraft:\n    image: felixklauke/paperspigot:1.16.5\n    container_name: minecraft\n    stdin_open: true\n    tty: true\n    restart: always\n    networks:\n      - minecraft\n    ports:\n      - 25565:25565\n    volumes:\n      - ./config:/opt/minecraft/config\n      - ./worlds:/opt/minecraft/worlds\n      - ./plugins:/opt/minecraft/plugins\n      - ./data:/opt/minecraft/data\n      - ./logs:/opt/minecraft/logs\n\nnetworks:\n  minecraft: {}\n\n```\n\n## Volumes\nIf you want to use explicit volumes, you can use this:\n```yaml \nversion: '3.7'\n\nservices:\n  minecraft:\n    image: felixklauke/paperspigot:1.16.5\n    container_name: minecraft\n    stdin_open: true\n    tty: true\n    restart: always\n    networks:\n      - minecraft\n    ports:\n      - 25565:25565\n    volumes:\n      - minecraft-config:/opt/minecraft/config\n      - minecraft-worlds:/opt/minecraft/worlds\n      - minecraft-plugins:/opt/minecraft/plugins\n      - minecraft-data:/opt/minecraft/data\n      - minecraft-logs:/opt/minecraft/logs\n\nvolumes:\n  minecraft-config: {}\n  minecraft-worlds: {}\n  minecraft-plugins: {}\n  minecraft-data: {}\n  minecraft-logs: {}\n\nnetworks:\n  minecraft: {}\n\n```\n\n# See Also\n- [Docker CLI Reference: docker cp](https://docs.docker.com/engine/reference/commandline/cp/) - Copy files/folders between \na container and the local filesystem. Useful if you want to add new plugins, change settings, etc.\n- [Docker CLI Reference: docker attach](https://docs.docker.com/engine/reference/commandline/attach/) - Attach to a\nrunning container. Will attach to the server's console directly, allowing you to issue commands. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixklauke%2Fpaper-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffelixklauke%2Fpaper-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffelixklauke%2Fpaper-docker/lists"}