binhex-minecraftserver

Overview

Minecraft is a sandbox video game created by Swedish game developer Markus Persson and released by Mojang in 2011. The game allows players to build with a variety of different blocks in a 3D procedurally generated world, requiring creativity from players. Other activities in the game include exploration, resource gathering, crafting, and combat. Multiple game modes that change gameplay are available, including—but not limited to—a survival mode, in which players must acquire resources to build the world and maintain health, and a creative mode, where players have unlimited resources to build with.

Runtime arguments

Web UI: http://[IP]:[PORT:8222]
Network: bridge
Shell: bash
Privileged: false
Extra Params: --restart=unless-stopped

Template configuration

Port: Web InterfacePorttcp

This is the Web UI port for the console.

Target: 8222
Default: 8222

Port: Minecraft Server connection (TCP)Porttcp

Minecraft Server connection (TCP).

Target: 25565
Default: 25565

Port: Minecraft Server connection (UDP)Portudp

Minecraft Server connection (UDP).

Target: 25565
Default: 25565

Path: /configPathrw

This is the container path to your configuration files, e.g. databases, configuration files, logs etc.

Target: /config
Default: /mnt/user/appdata/minecraftbedrockserver

Variable: CREATE_BACKUP_HOURSVariable

Specify the hour in 24 hour format to perform the backup.

Target: CREATE_BACKUP_HOURS
Default: 12

Variable: PURGE_BACKUP_DAYSVariable

Specify the number of days before a backup is considered for purging.

Target: PURGE_BACKUP_DAYS
Default: 14

Variable: ENABLE_WEBUI_CONSOLEVariable

Specify whether you want to enable the Web UI console.

Target: ENABLE_WEBUI_CONSOLE
Default: yes|no

Variable: ENABLE_WEBUI_AUTHVariable

Specify whether you want authentication prompts when connecting to the Web UI console.

Target: ENABLE_WEBUI_AUTH
Default: yes|no

Variable: WEBUI_USERVariable

Specify the Web UI username.

Target: WEBUI_USER
Default: admin

Variable: WEBUI_PASSVariable

Specify the Web UI password.

Target: WEBUI_PASS
Default: admin

Variable: WEBUI_CONSOLE_TITLEVariable

Specify the Web UI console title.

Target: WEBUI_CONSOLE_TITLE
Default: Minecraft Java Server

Variable: CUSTOM_JAR_PATHVariable

Specify the absolute path to custom Jar.

Target: CUSTOM_JAR_PATH
Default: /config/minecraft/minecraft_server.jar

Variable: JAVA_VERSIONVariable

Specify the version of Java Runtime.

Target: JAVA_VERSION
Default: latest|21|17|11|8

Variable: JAVA_INITIAL_HEAP_SIZEVariable

Specify the initial Java Heap size in MB.

Target: JAVA_INITIAL_HEAP_SIZE
Default: 512M

Variable: JAVA_MAX_HEAP_SIZEVariable

Specify the maximum Java Heap size in MB.

Target: JAVA_MAX_HEAP_SIZE
Default: 1024M

Variable: JAVA_MAX_THREADSVariable

Specify the maximum number of Java threads.

Target: JAVA_MAX_THREADS
Default: 1

Variable: JAVA_CUSTOM_ARGSVariable

Specify custom Java arguments.

Target: JAVA_CUSTOM_ARGS

Variable: STARTUP_CMDVariable

Specify the Minecraft command you want to run on startup of the server.

Target: STARTUP_CMD

Variable: ENABLE_HEALTHCHECKVariable

Enable or disable healthchecks.

Target: ENABLE_HEALTHCHECK
Default: yes|no

Variable: HEALTHCHECK_COMMANDVariable

The command or script to execute, if not specified then the script healthcheck.sh will be used (process, dns and https checking).

Target: HEALTHCHECK_COMMAND

Variable: HEALTHCHECK_ACTIONVariable

The action to execute if the healthcheck command returns a non zero exit code, if not specified the action will be 'exit 1', if you want the container to exit on failure then set the action to 'kill 1'.

Target: HEALTHCHECK_ACTION

Variable: HEALTHCHECK_HOSTNAMEVariable

The hostname used when performing HTTPS and DNS healthchecking.

Target: HEALTHCHECK_HOSTNAME
Default: google.com

Variable: PUIDVariable

User ID for the running container

Target: PUID
Default: 99

Variable: PGIDVariable

Group ID for the running container

Target: PGID
Default: 100

Variable: UMASKVariable

UMASK for the running container

Target: UMASK
Default: 000

Links

Template Support Registry Project

Details

Repository

ghcr.io/binhex/arch-minecraftserver

Registry

https://github.com/binhex/arch-minecraftserver/pkgs/container/arch-minecraftserver

Last Updated2026-04-09

First Seen2019-11-05

Run binhex-minecraftserver on Unraid.

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

Explore Unraid OS