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/

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

Categories

Download Statistics

419,968,126
Total Downloads
2,070,574
This Month
1,781,737
Avg / Month

Total Downloads Over Time

Loading chart...

Details

Repository
itzg/minecraft-server
Last Updated2026-04-16
First Seen2020-09-10

Run itzg-minecraft-server on Unraid.

itzg-minecraft-server is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.