itzg-minecraft-server

itzg-minecraft-server

Docker app from tatseo's Repository

Overview

This docker image provides a Minecraft Server that will automatically download the latest stable version at startup. You can also run/upgrade to any specific version or the latest snapshot. It will also automatically download given modpacks. Every Variable you might want to change is added. For more information see the offical docs: hub.docker.com/r/itzg/minecraft-server/

Docker Pulls Docker Stars GitHub Issues Discord Build and Publish Documentation Status

Read the docs

There you will find things like

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.

Sponsors

SpawnBox logo

SpawnBox - Powered by itzg/minecraft-server, it's a Windows desktop app for parents, teens, and friend groups who want a Minecraft server on their own PC without learning Docker, WSL2, or networking.


Server.pro logo

Server.pro - A game server hosting platform offering one-click Minecraft server deployment powered by itzg/minecraft-server, with global locations and an easy-to-use control panel.


and more...

Install itzg-minecraft-server on Unraid in a few clicks.

Find itzg-minecraft-server in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for itzg-minecraft-server Review the template variables and paths Click Install

Categories

Download Statistics

425,401,364
Total Downloads
1,956,530
This Month
2,214,341
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Explore more like this

Explore all

Details

Repository
itzg/minecraft-server
Last Updated2026-06-25
First Seen2020-09-10

Runtime arguments

Network
bridge
Shell
sh
Privileged
false
Extra Params
--health-cmd='mc-health' --health-interval=5s --health-retries=20 --health-timeout=5s --health-start-period=1m

Template configuration

Server Port TCPPorttcp
Target
25565
Default
25565
Value
25565
Server Port UDPPortudp
Target
25565
Default
25565
Value
25565
Server FilesPathrw
Target
/data
Value
/mnt/user/appdata/minecraft/
MemoryVariable

The image declares an initial and maximum Java memory-heap limit of 1 GB.

Target
MEMORY
Default
1G
Value
1G
TimezoneVariable
Target
TZ
Value
Europe/Berlin
Server typeVariable

Options: - VANILLA - AUTO_CURSEFORGE - FTBA - MODRINTH - BUKKIT - SPIGOT - CANYON - FABRIC - FORGE - MAGMA - MAGMA_MAINTAINED - KETTING - MOHIST - CATSERVER - SPONGEVANILLA - LIMBO - CRUCIBLE - PAPER - QUILT

Target
TYPE
Default
VANILLA
Value
VANILLA
Minecraft VersionVariable
Target
VERSION
Default
LATEST
Value
LATEST
Message of the DayVariable
Target
MOTD
Default
A Minecraft Docker Server
Value
A Minecraft Docker Server
DifficultyVariable

Options: - peaceful - easy - normal - hard

Target
DIFFICULTY
Value
easy
IconVariable

The url or file path for the icon image to use for the server. It will be downloaded, scaled, and converted to the proper format.

Target
ICON
Override IconVariable

The server icon which has been set doesn't get overridden by default. Set this to TRUE to override the icon

Target
OVERRIDE_ICON
Default
FALSE
Value
FALSE
Hardcore ModeVariable

If set to true, players will be set to spectator mode if they die.

Target
HARDCORE
Default
false
Value
false
World SeedVariable
Target
SEED
GamemodeVariable

Minecraft servers are configured to run in Survival mode by default. You can change the mode using MODE where you can either provide the standard numerical values or the shortcut values: creative survival adventure spectator(minecraft 1.8 or later)

Target
MODE
Value
survival
Server NameVariable
Target
SERVER_NAME
Value
A Docker Minecraft Server
Curseforge API KeyVariable

YOUR CurseForge (Eternal) API Key.

Target
CF_API_KEY
Curseforge URLVariable

Pass a page URL to the modpack or a specific file

Target
CF_PAGE_URL
Curseforge SlugVariable

Instead of a URL, the modpack slug can be provided.

Target
CF_SLUG
Curseforge Manual DownloadsPathrw

For mod, modpacks, and world files that are not allowed for automated download, the container path /downloads can be attached and matching files will be retrieved from there. The subdirectories mods, modpacks, and worlds will also be checked accordingly.

Target
/downloads
Value
/mnt/user/appdata/minecraft/downloads/
Max PlayersVariable
Target
MAX_PLAYERS
Value
20
Accept EULAVariable
Target
EULA
Default
TRUE
Value
TRUE
Snooper EnableVariable

If set to false, the server will not send data to snoop.minecraft.net server.

Target
SNOOPER_ENABLED
Default
true
Value
false
Spawn ProtectionVariable

Sets the area that non-ops can not edit (0 to disable)

Target
SPAWN_PROTECTION
Value
0
World GenerationVariable

For some of the level types, GENERATOR_SETTINGS can be used to further customize the world generation as described here.

Target
GENERATOR_SETTINGS
World TypeVariable

By default, a standard world is generated with hills, valleys, water, etc. A different level type can be configured by setting LEVEL_TYPE to an expected type listed here.

Target
LEVEL_TYPE
Value
minecraft:default
PVP ModeVariable

By default, servers are created with player-vs-player (PVP) mode enabled.

Target
PVP
Value
true
SavegameVariable

You can either switch between world saves or run multiple containers with different saves by using the LEVEL option

Target
LEVEL
Value
world
Server ConsoleVariable

If you would like to docker attach to the Minecraft server console with color and interactive capabilities, then set to true

Target
EXEC_DIRECTLY
Default
false
Value
true
Stop Announce DelayVariable

To allow time for players to finish what they're doing during a graceful server shutdown, set STOP_SERVER_ANNOUNCE_DELAY to a number of seconds to delay after an announcement is posted by the server.

Target
STOP_SERVER_ANNOUNCE_DELAY
Value
30
Fabric Launcher VersionVariable
Target
FABRIC_LAUNCHER_VERSION
Fabric Loader VersionVariable
Target
FABRIC_LOADER_VERSION
Forge VersionVariable
Target
FORGE_VERSION