Minepanel

Server Types ​

Minepanel supports both Java Edition and Bedrock Edition servers.

Server Types

Server Editions ​

EditionImageDefault PortProtocolProxy Support
Javaitzg/minecraft-server25565TCPYes (mc-router)
Bedrockitzg/minecraft-bedrock-server19132UDPNo

How It Works ​

Minepanel uses Docker images from itzg. When you create a server, it generates the appropriate Docker configuration automatically.

Documentation

Bedrock Edition ​

Minecraft Bedrock Edition server for cross-platform play (Windows 10/11, Xbox, PlayStation, Switch, iOS, Android).

Basic Setup ​

  1. Select Bedrock as server edition
  2. Choose version (LATEST, PREVIEW, or specific)
  3. Configure settings

Configuration Options ​

OptionVariableDescriptionDefault
VersionVERSIONServer versionLATEST
Server NameSERVER_NAMEServer display nameDedicated Server
GamemodeGAMEMODEsurvival, creative, adventuresurvival
DifficultyDIFFICULTYpeaceful, easy, normal, hardeasy
Allow CheatsALLOW_CHEATSEnable cheatsfalse
Max PlayersMAX_PLAYERSMaximum players10
View DistanceVIEW_DISTANCERender distance32
Tick DistanceTICK_DISTANCESimulation distance4
Online ModeONLINE_MODEXbox Live auth requiredtrue
White ListWHITE_LISTEnable whitelistfalse

Example Configuration ​

yaml
environment:
  EULA: 'TRUE'
  VERSION: LATEST
  SERVER_NAME: 'My Bedrock Server'
  GAMEMODE: survival
  DIFFICULTY: normal
  MAX_PLAYERS: 20
  ALLOW_CHEATS: 'false'

Permissions (XUIDs) ​

Bedrock uses Xbox User IDs (XUIDs) for permissions:

bash
# Operators
-e OPS="1234567890,0987654321"

# Members
-e MEMBERS="1234567890"

# Visitors
-e VISITORS="1234567890"

Finding XUIDs

Player XUIDs are logged when they join the server. You can also use online XUID lookup tools.

Allowlist ​

bash
# Enable allowlist with specific players
-e ALLOW_LIST=true
-e ALLOW_LIST_USERS="player1:1234567890,player2:0987654321"

Commands ​

Bedrock doesn't support RCON. Commands are executed via send-command:

bash
docker exec CONTAINER_NAME send-command gamerule dofiretick false

Command Output

Command output appears in server logs, not as a direct response. Check the Logs tab after executing commands.

Java Edition ​

World Sources (Folders/ZIP/TAR) ​

Minepanel includes world source management in General -> World for Java servers. It uses WORLD, LEVEL, and FORCE_WORLD_COPY from itzg/docker-minecraft-server.

  • Local world sources per server: servers/<server-id>/worlds/
  • Global world library shared by all servers: servers/.world/worlds/
  • Supported sources:
    • Folder containing level.dat
    • Archive files: .zip, .tar, .tar.gz, .tgz
  • The panel checks if the target level was already copied by looking for: servers/<server-id>/mc-data/<LEVEL>/level.dat

When a world is selected from General -> World, Minepanel updates compose config and restarts the server automatically if it is running.

You can classify worlds using subfolders (for example minigames/, skyblock/, modded/) in both local and global libraries.

World Library also includes a Discover Worlds panel:

  • Search worlds in CurseForge from the UI and import them into the global library
  • Import world archives from direct HTTPS URLs (.zip, .tar, .tar.gz, .tgz)
  • Imported files are stored under servers/.world/worlds/curseforge/ or servers/.world/worlds/url/

World Type (level-type) ​

The world type is set in General -> World via LEVEL_TYPE. Besides the standard presets (default, flat, large biomes, amplified, single biome surface), Java servers offer a Custom option to enter any level-type provided by a mod or modpack.

This is required for modpacks with their own world generation. For example, ATM10 To The Sky needs skyblockbuilder:skyblock; without it the itzg/docker-minecraft-server image rewrites server.properties on every start and the world regenerates as normal.

For CurseForge modpacks that ship a prebuilt world (To The Sky packs), you can also use CF_SET_LEVEL_FROM (WORLD_FILE or OVERRIDES) under the CurseForge advanced options so the modpack's bundled world is used.

Vanilla ​

Basic Minecraft server without mods or plugins.

yaml
environment:
  TYPE: VANILLA
  VERSION: 1.21.4

Fabric ​

A lightweight modding platform alternative to Forge.

Basic Setup ​

  1. Select Fabric as server type
  2. Choose your Minecraft version
  3. Optionally specify loader/launcher versions

Configuration Options ​

OptionVariableDescriptionDefault
Loader VersionFABRIC_LOADER_VERSIONFabric loader versionLatest
Launcher VersionFABRIC_LAUNCHER_VERSIONFabric launcher versionLatest
Custom LauncherFABRIC_LAUNCHERPath to custom launcher jar-
Launcher URLFABRIC_LAUNCHER_URLURL to custom launcher-
Force ReinstallFABRIC_FORCE_REINSTALLRe-install if corruptedfalse

Example Configuration ​

yaml
environment:
  TYPE: FABRIC
  VERSION: 1.21.4
  FABRIC_LOADER_VERSION: 0.13.1
  FABRIC_LAUNCHER_VERSION: 0.10.2

Fabric API

Most Fabric mods require the Fabric API mod. Install it easily using Modrinth.

Forge ​

The most popular mod loader with extensive mod compatibility.

Configuration Options ​

OptionVariableDescriptionDefault
Forge VersionFORGE_VERSIONForge build numberLatest for version

Example ​

yaml
environment:
  TYPE: FORGE
  VERSION: 1.20.4
  FORGE_VERSION: 43.2.0

Neoforge ​

A free, open-source, community-oriented modding API for Minecraft.

Configuration Options ​

OptionVariableDescriptionDefault
Neoforge VersionNEOFORGE_VERSIONNeoforge build numberLatest for version

Example ​

yaml
environment:
  TYPE: NEOFORGE
  VERSION: 1.21.1
  NEOFORGE_VERSION: 21.1.219

Paper ​

High-performance Spigot fork with plugins support.

Configuration Options ​

OptionVariableDescriptionDefault
BuildPAPER_BUILDSpecific Paper buildLatest
ChannelPAPER_CHANNELRelease channeldefault
Download URLPAPER_DOWNLOAD_URLCustom download URL-

Example ​

yaml
environment:
  TYPE: PAPER
  VERSION: 1.21.4
  PAPER_BUILD: 120

Spigot ​

Popular plugin-based server.

Configuration Options ​

OptionVariableDescriptionDefault
Download URLSPIGOT_DOWNLOAD_URLCustom download URL-
Build from SourceBUILD_FROM_SOURCECompile from sourcefalse

Example ​

yaml
environment:
  TYPE: SPIGOT
  VERSION: 1.20.4

Bukkit ​

The original plugin platform.

Configuration Options ​

OptionVariableDescriptionDefault
Download URLBUKKIT_DOWNLOAD_URLCustom download URL-
Build from SourceBUILD_FROM_SOURCECompile from sourcefalse

Purpur ​

Fork of Paper with additional features.

Configuration Options ​

OptionVariableDescriptionDefault
BuildPURPUR_BUILDSpecific Purpur buildLatest
Download URLPURPUR_DOWNLOAD_URLCustom download URL-
Flare FlagsUSE_FLARE_FLAGSUse Flare performance flagsfalse

Pufferfish ​

Paper fork focused on performance.

Configuration Options ​

OptionVariableDescriptionDefault
BuildPUFFERFISH_BUILDSpecific buildLatest
Flare FlagsUSE_FLARE_FLAGSUse Flare flagsfalse

Folia ​

Experimental multi-threaded Paper fork.

Configuration Options ​

OptionVariableDescriptionDefault
BuildFOLIA_BUILDSpecific buildLatest
ChannelFOLIA_CHANNELRelease channeldefault
Download URLFOLIA_DOWNLOAD_URLCustom URL-

Leaf ​

Another Paper fork with optimizations.

Configuration Options ​

OptionVariableDescriptionDefault
BuildLEAF_BUILDSpecific buildLatest

Modrinth Modpacks ​

Install complete modpacks from Modrinth.

Installation Methods ​

1. Slug:

yaml
environment:
  TYPE: MODRINTH
  MODRINTH_MODPACK: surface-living

2. URL:

yaml
environment:
  TYPE: MODRINTH
  MODRINTH_MODPACK: https://modrinth.com/modpack/surface-living

2. URL (with version locking):

yaml
environment:
  TYPE: MODRINTH
  MODRINTH_MODPACK: https://modrinth.com/modpack/surface-living/version/1.2.1

GT New Horizons (GTNH) ​

Install GT New Horizons using the dedicated GTNH server type.

  • TYPE=GTNH
  • GTNH_PACK_VERSION=2.8.1
  • GTNH_DELETE_BACKUPS=false
  • SKIP_GTNH_UPDATE_CHECK=false
  • LEVEL_TYPE=rwg
  • DIFFICULTY=hard
  • ALLOW_FLIGHT=true
  • ENABLE_COMMAND_BLOCK=true

GTNH options ​

OptionVariableDescriptionDefault
Pack VersionGTNH_PACK_VERSIONlatest, latest-dev, or a fixed version like 2.8.12.8.1
Delete BackupsGTNH_DELETE_BACKUPSRemove config backup folders created during upgradesfalse
Skip Update CheckSKIP_GTNH_UPDATE_CHECKSkip the GTNH update/install check after first installfalse

Notes ​

  • GTNH targets Minecraft 1.7.10
  • Java 17+ is recommended
  • java25 is preferred for GTNH 2.8.0+
  • Enable SKIP_GTNH_UPDATE_CHECK only after the initial install if you want to freeze updates

CurseForge Modpacks ​

Install complete modpacks from CurseForge.

API Key Required

You need a CurseForge API key. Get one from CurseForge for Studios.

Installation Methods ​

1. URL Method (easiest):

yaml
environment:
  TYPE: AUTO_CURSEFORGE
  CF_API_KEY: your_key
  CF_PAGE_URL: https://www.curseforge.com/minecraft/modpacks/all-the-mods-9/download/5464988

2. Slug + File ID:

yaml
environment:
  TYPE: AUTO_CURSEFORGE
  CF_API_KEY: your_key
  CF_SLUG: all-the-mods-9
  CF_FILE_ID: 5464988

3. Auto-select latest:

yaml
environment:
  TYPE: AUTO_CURSEFORGE
  CF_API_KEY: your_key
  CF_SLUG: all-the-mods-9

Advanced Options ​

OptionVariableDescriptionDefault
Force SyncCF_FORCE_SYNCHRONIZERe-download even if existsfalse
Parallel DownloadsCF_PARALLEL_DOWNLOADSConcurrent downloads4
Skip ExistingCF_OVERRIDES_SKIP_EXISTINGDon't overwrite filesfalse
Set Level FromCF_SET_LEVEL_FROMWorld source: WORLD_FILE, OVERRIDES-
Force IncludeCF_FORCE_INCLUDE_MODSForce download specific mods-
Exclude ModsCF_EXCLUDE_MODSExclude specific mods-

Feed The Beast (FTBA) ​

Install Feed The Beast modpacks using the dedicated FTBA server type. The pack pins its own Minecraft and mod loader version, so you don't set a Minecraft version manually. No CurseForge API key is required.

Installation Methods ​

1. Latest version:

yaml
environment:
  TYPE: FTBA
  FTB_MODPACK_ID: 119

2. Locked to a specific version:

yaml
environment:
  TYPE: FTBA
  FTB_MODPACK_ID: 119
  FTB_MODPACK_VERSION_ID: 12179

FTBA options ​

OptionVariableDescriptionDefault
Modpack IDFTB_MODPACK_IDNumeric modpack ID from the pack page on feed-the-beast.comrequired
Modpack Version IDFTB_MODPACK_VERSION_IDNumeric version ID; omit to always install the latestlatest

Notes ​

  • Find the modpack ID on the pack's page at feed-the-beast.com
  • Leave FTB_MODPACK_VERSION_ID empty to always install the latest available version

Server Type Categories ​

CategoryTypesUse Case
🟡 BedrockBEDROCKCross-platform (consoles, mobile, Windows 10/11)
🟢 VanillaVANILLAPure Minecraft Java, no modifications
🔵 Mod LoadersForge, Neoforge, FabricClient-side mods required
🟣 Plugin ServersPaper, Spigot, Purpur, Pufferfish, FoliaServer-side plugins, vanilla clients
🟠 ModpacksAUTO_CURSEFORGE, Modrinth, GTNH, FTBAPre-configured mod collections

Next Steps ​

External Resources ​

Java Edition:

Bedrock Edition:

Released under the MIT License. · Anonymous, cookieless analytics (self-hosted Umami).

Copyright © 2024-2026 Ketbome