# itzg/docker-minecraft-server

Docker image that provides a Minecraft Server for Java Edition that automatically installs/upgrades versions, modloaders, modpacks and more at startup

Repository: https://github.com/itzg/docker-minecraft-server
Canonical: https://ross.abutalabs.com/products/docker-minecraft-server
Homepage: https://docker-minecraft-server.readthedocs.io/
Language: Shell
License: Apache-2.0
License Family: permissive
Topics: minecraft-server, dockerfiles, docker-image, hacktoberfest, java
Last push: 2026-08-26T21:37:40+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 4491, "days_push": 7, "days_rel": 10, "gap_med": 10.5, "n_releases_24m": 55}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 14214, forks 1909 (observed 2026-08-28T04:11:06.441659+00:00)

## What it is
A Docker image that runs a Minecraft Java Edition server, automatically downloading and upgrading the server version, modloaders, and modpacks at startup. It is configured via environment variables and supports many server types such as vanilla, Forge, Fabric, and Paper.

## Use cases
- spin up a Minecraft server with docker compose
- automatically keep a Minecraft server updated to the latest version
- run a modded Minecraft server with Forge or Fabric
- host a modpack server like CurseForge or FTB in a container
- configure server.properties via environment variables
- run a Minecraft server on Kubernetes

## When to choose
- you want a self-hosted Minecraft Java Edition server managed by Docker
- you need automated version upgrades, mod, and modpack installation
- you want declarative configuration via environment variables and compose files

## When to avoid
- you need a Bedrock Edition server natively (use itzg/minecraft-bedrock-server)
- you want a GUI-based server manager without Docker
- you cannot run containers on your host

## Facets
- artifact type: application
- maturity: active
- function: self-hosted, deployment, configuration-management, developer-tools
- domain: gaming-tools, self-hosted
- platform: self-hosted
- tags: minecraft-server, docker-image, modloaders, modpacks, server-hosting, java-edition, minecraft, containers, automation, docker, linux, kubernetes

## Member repositories
- itzg/docker-minecraft-server (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:06.441659+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:12:43.772734+00:00, confidence not recorded.
  - readme: https://github.com/itzg/docker-minecraft-server (fetched 2026-08-28T04:11:06.441659+00:00, sha c574b1fd2260)
  - homepage: https://docker-minecraft-server.readthedocs.io/ (fetched 2026-08-29T08:06:19.718036+00:00, sha e49c55357b9f)
- Data as of 2026-08-30T08:39:29.467469+00:00.