This stack runs a Minecraft Java Edition server with the itzg/minecraft-server image, which supports Vanilla, Paper, Fabric, Forge, and other server types. Players connect to it over your Tailnet.
This stack runs Minecraft Server with a Tailscale sidecar, as described in the standard setup.
| Item | Value |
|---|---|
| Web interface | None |
| Game server | minecraft.<tailnet>.ts.net, TCP port 25565 |
| Image | itzg/minecraft-server |
| Data | ./minecraft-data (world, configuration, and server files) |
The defaults work without changes. You can adjust these values in .env:
| Variable | Default | Description |
|---|---|---|
SERVER_TYPE |
VANILLA |
Server software: VANILLA, PAPER, FABRIC, FORGE, SPIGOT, BUKKIT |
MINECRAFT_VERSION |
LATEST |
Game version: LATEST or a fixed version such as 1.21.4 |
DIFFICULTY |
normal |
Game difficulty: peaceful, easy, normal, hard |
MAX_PLAYERS |
10 |
Maximum number of players at the same time |
MOTD |
A Minecraft Server on Tailscale |
Message in the server list |
MEMORY |
2G |
Java heap size; increase it for larger worlds or more players |
- No Tailscale Serve. Minecraft uses its own protocol on TCP port
25565, which Tailscale Serve does not forward. The server listens on that port of the Tailscale IP address of the device, and the stack has no Serve configuration. - License agreement.
compose.yamlsetsEULA=TRUE, which accepts the Minecraft End User License Agreement for you.
- Start the stack. The first start takes a while, because the image downloads the server.
- In Minecraft, select Multiplayer > Add Server and enter
minecraft.<tailnet>.ts.net.
All players must be on your Tailnet, or you must share the device with them.
- Bedrock Edition. Bedrock uses UDP port
19132and another server type, which this stack does not set up.