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

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 4 minutes ago
Added to GitGenius on September 4th, 2026
Created on May 17th, 2014
Open Issues & Pull Requests: 140 (+1)
GitHub issues: Enabled
Number of forks: 1,914
Total Stargazers: 14,271 (+0)
Total Subscribers: 76 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 1.2 hours
Mean response time: 13.2 days
90th percentile: 13.7 hours
Tracked items: 401

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 81% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Only 6% of issues opened in the past year have been closed. Three people close 62% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 58
New in 7 days: 0
Closed in 7 days: 2
Avg open age: 606 days
Stale 30+ days: 56
Stale 90+ days: 47

Recent activity

Opened in 7 days: 0
Closed in 7 days: 2
Comments in 7 days: 0
Events in 7 days: 1

Top labels

  • discussion (150)
  • enhancement (120)
  • status/stale (107)
  • bug (103)
  • help wanted (44)
  • status/needs triage (40)
  • documentation (7)
  • reason/upstream (7)

Most active issues this week

Detailed Description

docker-minecraft-server is a Docker image that runs a Minecraft Java Edition server with automatic installation and upgrading of versions, modloaders, and modpacks at startup.

The tool solves the problem of setting up and maintaining a Minecraft server by packaging the server runtime and all configuration logic into a container. It handles version management automatically, allowing you to specify which Minecraft version to run and have it downloaded and installed on container startup. Server properties can be configured through environment variables rather than editing files directly. The image supports multiple server types and can automatically download and manage mods and plugins, cleaning them up when no longer needed.

This approach works well for anyone wanting to run a Minecraft Java Edition server without manual installation steps or version management. It suits projects ranging from small friend groups to larger deployments, since Docker Compose examples are provided for quick setup. The tool supports various modpack providers and platforms, making it flexible for different gameplay styles. If you need Bedrock Edition compatibility, the README notes that a separate image exists for that purpose, or you can add Bedrock support to a Java server through documented configuration.

Development activity shows consistent engagement with the project. The repository maintains comprehensive documentation covering quick starts, version selection, server types, environment variable configuration, and mod management. Multiple real-world examples are included in the repository to guide users through common setups. The project has attracted enough adoption that several hosted services have been built on top of it, indicating both stability and community confidence in the codebase.