Self-host Minecraft Server on a VPS

A Minecraft Java server (vanilla, Paper, Fabric or Forge via the server type field) that downloads the selected version on first boot (default 1.21.11, tested on the Java 21 image). You must accept the Minecraft EULA yourself by entering TRUE; it is never accepted for you. Players connect to TCP 25565 (no web address is created for it): the port binds privately by default, so set a public bind in the app's Network settings and open TCP 25565 in the host and cloud firewall. RCON is on with a generated password but its port is not published; run apps console from the CLI. The JVM heap is the memory field and the container limit defaults to 2560M, 25 percent above the 2G heap. Defaults suit 2 CPUs and 12 GB of RAM shared with other apps. Image is multi-arch (amd64 and arm64).

Needs configuration: set EULA before the first start.

levelrail-cli templates install minecraft --name my-minecraft --env EULA=VALUE

Specification

Status
Listed
Category
Games
Services
minecraft
Ports
25565
Volumes
1
Memory
about 2.5 GiB
arm64
image published
amd64
image published
Settings to fill in
1
License
not yet recorded

About Minecraft Server

A Minecraft Java server (vanilla, Paper, Fabric or Forge via the server type field) that downloads the selected version on first boot (default 1.21.11, tested on the Java 21 image). You must accept the Minecraft EULA yourself by entering TRUE; it is never accepted for you. Players connect to TCP 25565 (no web address is created for it): the port binds privately by default, so set a public bind in the app's Network settings and open TCP 25565 in the host and cloud firewall. RCON is on with a generated password but its port is not published; run apps console from the CLI. The JVM heap is the memory field and the container limit defaults to 2560M, 25 percent above the 2G heap. Defaults suit 2 CPUs and 12 GB of RAM shared with other apps. Image is multi-arch (amd64 and arm64).

What it deploys

Minecraft Server runs as one service in a single Compose app, listening on port 25565, with 1 named volume mount.

ServiceImageTagPortsVolumes
minecraft itzg/minecraft-server 2026.10.1-java21 25565 minecraft_data -> /data

Before you install

  • CPU architecture. arm64 listed. Every image lists linux/arm64 in its registry manifest. That is a manifest fact, not proof the app runs on Arm.
  • Listed. It is in the catalog. Back up the data volume before changing an image tag.
  • Host ports. It publishes port 25565 directly on the host, so open them in the VPS firewall only if you want that.

Settings and environment

You must set EULA. 1 secret is generated at deploy and stored encrypted. Values are never shown here.

ServiceVariableValue
minecraftDIFFICULTYPreset by the template
minecraftENABLE_RCONPreset by the template
minecraftENABLE_WHITELISTPreset by the template
minecraftENFORCE_WHITELISTPreset by the template
minecraftEULAYou must set this
minecraftMAX_PLAYERSPreset by the template
minecraftMEMORYPreset by the template
minecraftOPSPreset by the template
minecraftRCON_PASSWORDGenerated at deploy
minecraftSIMULATION_DISTANCEPreset by the template
minecraftTYPEPreset by the template
minecraftUSE_AIKAR_FLAGSPreset by the template
minecraftVERSIONPreset by the template
minecraftVIEW_DISTANCEPreset by the template
minecraftWHITELISTPreset by the template

Install Minecraft Server on a VPS

  1. Install Levelrail on a fresh VPS

    Run this as root on a Linux server (amd64 or arm64) with ports 80 and 443 reachable. The installer prints a setup link.

    curl -fsSL https://levelrail.com/install.sh | sudo sh
  2. Sign in

    Open the setup link, choose a password, then log the CLI in. The CLI install command is curl -fsSL https://levelrail.com/install-cli.sh | sh if the machine does not have it. See Getting started.

    levelrail-cli login --device
  3. Read the template

    Shows the entry, including its full compose.yaml.

    levelrail-cli templates get minecraft
  4. Install it

    This template has an install form, so the CLI fills each setting from --env, a generated secret or its default. Replace VALUE with your own EULA.

    levelrail-cli templates install minecraft --name my-minecraft --env EULA=VALUE

    To put a service behind a domain at install, add --domain SERVICE=HOST:

    levelrail-cli templates install minecraft --name my-minecraft --domain minecraft=minecraft.example.com

Without a domain the app gets an sslip.io address. You can also deploy it from the dashboard: Apps, New app, Browse templates, then Minecraft Server.

More in Games

All Games templates