Expose and document IPv6 port 19133 by default (#626)

This commit is contained in:
Kai P. authored and GitHub committed 2026-04-30 19:29:32 -05:00
1 parent 86c278f32f
commit 09b8859600
6 files changed
+31 -7

No files matched your search

+3 -1
View File
@@ -12,6 +12,7 @@ ARG BOX64_PACKAGE=box64
RUN --mount=target=/build,source=build BOX64_PACKAGE=$BOX64_PACKAGE /build/setup-arm64 RUN --mount=target=/build,source=build BOX64_PACKAGE=$BOX64_PACKAGE /build/setup-arm64
EXPOSE 19132/udp EXPOSE 19132/udp
EXPOSE 19133/udp
VOLUME ["/data"] VOLUME ["/data"]
@@ -58,7 +59,8 @@ COPY bin/* /usr/local/bin/
# https://minecraft.wiki/w/Bedrock_Edition_1.13.0 # https://minecraft.wiki/w/Bedrock_Edition_1.13.0
# https://minecraft.wiki/w/Bedrock_Edition_1.14.0 # https://minecraft.wiki/w/Bedrock_Edition_1.14.0
ENV VERSION=LATEST \ ENV VERSION=LATEST \
SERVER_PORT=19132 SERVER_PORT=19132 \
SERVER_PORT_V6=19133
HEALTHCHECK --start-period=1m CMD /usr/local/bin/mc-monitor status-bedrock --host 127.0.0.1 --port $SERVER_PORT HEALTHCHECK --start-period=1m CMD /usr/local/bin/mc-monitor status-bedrock --host 127.0.0.1 --port $SERVER_PORT
+13 -4
View File
@@ -7,12 +7,18 @@
## Quickstart ## Quickstart
The following starts a Bedrock Dedicated Server running a default version and The following starts a Bedrock Dedicated Server running a default version and
exposing the default UDP port: exposing the default IPv4 UDP port:
```bash ```bash
docker run -d -it -e EULA=TRUE -p 19132:19132/udp -v mc-bedrock-data:/data itzg/minecraft-bedrock-server docker run -d -it -e EULA=TRUE -p 19132:19132/udp -v mc-bedrock-data:/data itzg/minecraft-bedrock-server
``` ```
If your network is dual-stack (IPv4 and IPv6), also map the IPv6 port:
```bash
-p 19132:19132/udp -p 19133:19133/udp
```
> **NOTE**: if you plan on running a server for a longer amount of time it is highly recommended using a management layer such as [Docker Compose](#deploying-with-docker-compose) or [Kubernetes](#deploying-with-kubernetes) to allow for incremental reconfiguration and image upgrades. > **NOTE**: if you plan on running a server for a longer amount of time it is highly recommended using a management layer such as [Docker Compose](#deploying-with-docker-compose) or [Kubernetes](#deploying-with-kubernetes) to allow for incremental reconfiguration and image upgrades.
## Upgrading to the latest Bedrock server version ## Upgrading to the latest Bedrock server version
@@ -148,8 +154,10 @@ docker run -d -it --name bds-flat-creative \
## Exposed Ports ## Exposed Ports
- **UDP** 19132 : the Bedrock server port on IPv4 set by `SERVER_PORT`. The IPv6 port is not exposed by default. - **UDP** 19132 : the Bedrock server port for IPv4 clients, set by `SERVER_PORT`
**NOTE** that you must append `/udp` when exposing the port, such as `-p 19132:19132/udp` and both IPv4 and IPv6 must be enabled on your host machine. - **UDP** 19133 : the Bedrock server port for IPv6 clients, set by `SERVER_PORT_V6`
**NOTE** that you must append `/udp` when exposing the ports, such as `-p 19132:19132/udp -p 19133:19133/udp`.
## Volumes ## Volumes
@@ -335,7 +343,7 @@ When finished, detach from the server console using Ctrl-p, Ctrl-q
## Deploying with Docker Compose ## Deploying with Docker Compose
The [examples](examples) directory contains [an example Docker compose file](examples/docker-compose.yml) that declares: The [examples](examples) directory contains [an example Docker compose file](examples/docker-compose.yml) that declares:
- a service running the bedrock server container and exposing UDP port 19132. In the example is named "bds", short for "Bedrock Dedicated Server", but you can name the service whatever you want - a service running the bedrock server container and exposing UDP ports 19132 (IPv4) and 19133 (IPv6). In the example is named "bds", short for "Bedrock Dedicated Server", but you can name the service whatever you want
- a volume attached to the service at the container path `/data` - a volume attached to the service at the container path `/data`
```yaml ```yaml
@@ -346,6 +354,7 @@ services:
EULA: "TRUE" EULA: "TRUE"
ports: ports:
- "19132:19132/udp" - "19132:19132/udp"
- "19133:19133/udp"
volumes: volumes:
- ./data:/data - ./data:/data
stdin_open: true stdin_open: true
+1 -1
View File
@@ -20,7 +20,7 @@ $STORAGE_KEY=$(az storage account keys list --resource-group mineResGroup --acco
echo $STORAGE_KEY echo $STORAGE_KEY
#to actually create the minecraft server int the dns name "minesvrbedrock" #to actually create the minecraft server int the dns name "minesvrbedrock"
#the server will be running into server "minesvrbedrock.southcentralus.azurecontainer.io" port "19132", this take some time be patient. #the server will be running into server "minesvrbedrock.southcentralus.azurecontainer.io" ports "19132" (IPv4) and "19133" (IPv6), this take some time be patient.
az container create --resource-group mineResGroup --name minecotainer --image itzg/minecraft-bedrock-server --dns-name-label minesvrbedrock --ports 19132 19133 --protocol udp --restart-policy OnFailure --environment-variables EULA=TRUE --azure-file-volume-account-name acismineacc --azure-file-volume-account-key $STORAGE_KEY --azure-file-volume-share-name acismineshare --azure-file-volume-mount-path /data az container create --resource-group mineResGroup --name minecotainer --image itzg/minecraft-bedrock-server --dns-name-label minesvrbedrock --ports 19132 19133 --protocol udp --restart-policy OnFailure --environment-variables EULA=TRUE --azure-file-volume-account-name acismineacc --azure-file-volume-account-key $STORAGE_KEY --azure-file-volume-share-name acismineshare --azure-file-volume-mount-path /data
#connect to fileshare drive "M" to edit server.properties and everything else #connect to fileshare drive "M" to edit server.properties and everything else
+1
View File
@@ -5,6 +5,7 @@ services:
EULA: "TRUE" EULA: "TRUE"
ports: ports:
- "19132:19132/udp" - "19132:19132/udp"
- "19133:19133/udp"
volumes: volumes:
- ./data:/data - ./data:/data
stdin_open: true stdin_open: true
@@ -82,6 +82,8 @@ spec:
ports: ports:
- containerPort: 19132 - containerPort: 19132
protocol: UDP protocol: UDP
- containerPort: 19133
protocol: UDP
readinessProbe: &probe readinessProbe: &probe
exec: exec:
command: command:
@@ -115,3 +117,5 @@ spec:
ports: ports:
- port: 19132 - port: 19132
protocol: UDP protocol: UDP
- port: 19133
protocol: UDP
+9 -1
View File
@@ -17,6 +17,7 @@ data:
#LEVEL_SEED: "33480944" #LEVEL_SEED: "33480944"
#SERVER_NAME: "my_minecraft_server" #SERVER_NAME: "my_minecraft_server"
#SERVER_PORT: "19132" #SERVER_PORT: "19132"
#SERVER_PORT_V6: "19133"
#LEVEL_TYPE: "DEFAULT" # Options: FLAT, LEGACY, DEFAULT #LEVEL_TYPE: "DEFAULT" # Options: FLAT, LEGACY, DEFAULT
#ALLOW_CHEATS: "false" # Options: true, false #ALLOW_CHEATS: "false" # Options: true, false
#MAX_PLAYERS: "10" #MAX_PLAYERS: "10"
@@ -63,6 +64,8 @@ spec:
ports: ports:
- containerPort: 19132 - containerPort: 19132
protocol: UDP protocol: UDP
- containerPort: 19133
protocol: UDP
readinessProbe: &probe readinessProbe: &probe
exec: exec:
command: command:
@@ -92,10 +95,15 @@ metadata:
spec: spec:
selector: selector:
app: bds app: bds
ipFamilyPolicy: PreferDualStack
ipFamilies:
- IPv4
- IPv6
ports: ports:
- port: 19132 - port: 19132
protocol: UDP protocol: UDP
ipFamily: IPv4 - port: 19133
protocol: UDP
# Use LoadBalancer if running on a provider that supports that # Use LoadBalancer if running on a provider that supports that
# type: LoadBalancer # type: LoadBalancer
# or use NodePort on a non-managed system; # or use NodePort on a non-managed system;