mirror/docker-minecraft-server: Docker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup

mirror of https://github.com/itzg/docker-minecraft-server.git synced 2026-04-07 23:01:05 +00:00

Docker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup https://docker-minecraft-server.readthedocs.io/

dockerfiles docker-image hacktoberfest java minecraft-server

Find a file

dependabot[bot] 23205471db build(deps): bump the patches group in /docs with 2 updates (#4001 )		2026-04-06 07:49:39 -05:00
.github	Pin mcVersion to 1.21.11 for Java 21 build testing (#3991 )	2026-03-26 15:54:10 -05:00
build	Added NUMA library (#3962 )	2026-03-07 08:54:18 -06:00
docs	build(deps): bump the patches group in /docs with 2 updates (#4001 )	2026-04-06 07:49:39 -05:00
examples	Support Purpur and Pufferfish config repos & optimize server.properties handling (#3914 )	2026-02-09 15:03:15 -06:00
files	Added default exclude of smooth swapping (#3992 )	2026-03-31 11:38:50 -05:00
kustomize	docs: add service annotation patching to example kustomization (#3020 )	2024-07-28 13:28:42 -05:00
notes	notes: removed start-setupForgeApiMods from start flow diagram (#3972 )	2026-03-12 16:08:06 -05:00
scripts	Consider MODRINTH_PROJECTS_DEFAULT_VERSION_TYPE as part of VERSION_FROM_MODRINTH_PROJECTS (#3985 )	2026-03-22 19:52:07 -05:00
tests	Exclude Netty http3 to ensure Alpine musl support (#3765 )	2025-11-15 11:54:40 -06:00
.dockerignore	Added testdata to dockerignore	2020-08-02 19:57:47 -05:00
.editorconfig	misc: added EOL config to .editorconfig	2020-08-12 20:47:52 -05:00
.gitignore	Move docs to zensical (#3852 )	2026-01-06 06:36:04 -06:00
.readthedocs.yaml	build: adjust RTD config to explicitly use docs/requirements.txt (#3964 )	2026-03-07 14:08:54 -06:00
compose-dev.yml	Temporarily replace GTNH ServerPacks call with restify+jq (#3938 )	2026-02-15 17:33:46 -06:00
compose-docs.yml	Move docs to zensical (#3852 )	2026-01-06 06:36:04 -06:00
docker-compose.yml	Remove version from docker compose since it's been deprecated (#2816 )	2024-05-06 14:35:50 -05:00
Dockerfile	chore(deps): update dependency itzg/mc-server-runner to v1.14.5 (#3999 )	2026-04-05 10:07:11 -05:00
images.json	Add image variant java25-alpine (#3980 )	2026-03-17 21:06:00 -05:00
LICENSE	Initial commit	2014-05-17 15:38:17 -07:00
README.md	Update build badge in README.md (#3898 )	2026-02-01 15:30:55 -06:00
renovate.json5	Markup other dependencies in Dockerfile for Renovate (#3945 )	2026-02-16 14:11:57 -06:00
zensical.toml	Leave docs sidebar nav collapsed by default (#3892 )	2026-01-28 19:32:47 -06:00

README.md

There you will find things like

Quick start with Docker Compose
Running different versions of Minecraft and using various server types for Java Edition
Setting server properties via container environment variables
Managing mods and plugins with automated downloads and cleanup
Using various modpack providers/platforms
...and much more

There are also many examples located in the examples directory of this repo.

This image only supports Java edition natively; however, if looking for a server that is compatible with Bedrock edition, then use itzg/minecraft-bedrock-server or refer to this section to add Bedrock compatibility to a Java edition server.