80 lines
2.7 KiB
Markdown
80 lines
2.7 KiB
Markdown
[](https://hub.docker.com/r/itzg/minecraft-bedrock-server/)
|
|
[](https://github.com/itzg/docker-minecraft-bedrock-server/issues)
|
|
[](https://gitter.im/itzg/dockerfiles)
|
|
[](https://www.buymeacoffee.com/itzg)
|
|
|
|
## Quickstart
|
|
|
|
The following starts a Bedrock Dedicated Server running a default version and
|
|
exposing the default UDP port:
|
|
|
|
```bash
|
|
docker run -d -e EULA=TRUE -p 19132:19132/udp itzg/minecraft-bedrock-server
|
|
```
|
|
|
|
## Looking for a Java Edition Server
|
|
|
|
For Minecraft Java Edition you'll need to use this image instead:
|
|
|
|
[itzg/minecraft-server](https://hub.docker.com/r/itzg/minecraft-server)
|
|
|
|
## Environment Variables
|
|
|
|
### Container Specific
|
|
|
|
- `EULA` (no default) : must be set to `TRUE` to
|
|
accept the [Minecraft End User License Agreement](https://minecraft.net/terms)
|
|
- `VERSION` (1.12) : can be set to a specific server version or just 1.11 or 1.12 to pick
|
|
the latest known version of each
|
|
- `UID` (default derived from `/data` owner) : can be set to a specific user ID to run the
|
|
bedrock server process
|
|
- `GID` (default derived from `/data` owner) : can be set to a specific group ID to run the
|
|
bedrock server process
|
|
|
|
### Server Properties
|
|
|
|
The following environment variables will set the equivalent property in `server.properties`, where each [is described here](https://minecraft.gamepedia.com/Server.properties#Bedrock_Edition_3).
|
|
|
|
- `SERVER_NAME`
|
|
- `GAMEMODE`
|
|
- `DIFFICULTY`
|
|
- `LEVEL_TYPE`
|
|
- `ALLOW_CHEATS`
|
|
- `MAX_PLAYERS`
|
|
- `ONLINE_MODE`
|
|
- `WHITE_LIST`
|
|
- `VIEW_DISTANCE`
|
|
- `TICK_DISTANCE`
|
|
- `PLAYER_IDLE_TIMEOUT`
|
|
- `MAX_THREADS`
|
|
- `LEVEL_NAME`
|
|
- `LEVEL_SEED`
|
|
- `DEFAULT_PLAYER_PERMISSION_LEVEL`
|
|
- `TEXTUREPACK_REQUIRED`
|
|
|
|
For example, to configure a flat, creative server instead of the default use:
|
|
|
|
```bash
|
|
docker run -d --name bds-flat-creative \
|
|
-e EULA=TRUE -e LEVEL_TYPE=flat -e GAMEMODE=creative \
|
|
-p 19132:19132/udp itzg/minecraft-bedrock-server
|
|
```
|
|
|
|
|
|
## Exposed Ports
|
|
|
|
- **UDP** 19132 : the Bedrock server port.
|
|
**NOTE** that you must append `/udp` when exposing the port, such as `-p 19132:19132/udp`
|
|
|
|
## Volumes
|
|
|
|
- `/data` : the location where the downloaded server is expanded and ran. Also contains the
|
|
configuration properties file `server.properties`
|
|
|
|
## Connecting
|
|
|
|
When running the container on your LAN, you can find and connect to the dedicated server
|
|
in the "LAN Games" part of the "Friends" tab, such as:
|
|
|
|

|