Docker Installation

Running PowerNukkitX in a Docker container is a clean and convenient way to host your server. The official Docker image is available on Docker Hub as powernukkitx/server.

Quick Start

To start a PowerNukkitX container listening on the default Bedrock port (19132/udp), run the following command:

docker run -d \
  --name pnx-server \
  -p 19132:19132/udp \
  -v /path/to/your/data:/data \
  powernukkitx/server

Volume Mounts

The container exposes two volumes:

• /data (Recommended): Stores all configuration files (pnx.yml), worlds/, plugins/, resource_packs/, and logs/.
• /home/minecraft (Optional): Stores user-specific JLine cache files.

Docker Compose

Using Docker Compose simplifies managing your server configuration. Create a docker-compose.yml file in a directory of your choice:

services:
  pnx-server:
    image: powernukkitx/server:latest
    container_name: pnx-server
    ports:
      - "19132:19132/udp"
    volumes:
      - ./data:/data
    restart: unless-stopped

Start the server in the background:

docker compose up -d

Console Access

Because PowerNukkitX runs in the background, you cannot type commands directly. To access the interactive server console to run commands (like /op or /stop):

docker attach pnx-server

To detach from the console without stopping the container, press Ctrl + P followed by Ctrl + Q.

Custom JVM Options & Arguments

The Dockerfile defines java as the entrypoint. By default, it runs with the following optimized arguments:

• Garabage Collector: -XX:+UseZGC, -XX:+ZGenerational, -XX:+UseStringDeduplication
• JVM Reflection Flags: --add-opens flags for reflection access.
• Startup flags: --skip-setup, --accept-license, --language eng (these automatically bypass the setup wizard and accept the license for non-interactive execution).

If you want to customize the startup arguments (for example, to change the maximum Java heap size to 4GB), you must override the container's default command by specifying the full class path and class name:

docker run -d \
  --name pnx-server \
  -p 19132:19132/udp \
  -v /path/to/your/data:/data \
  powernukkitx/server \
  -Xmx4G -Xms1G \
  -cp /app/powernukkitx.jar:./libs/* \
  org.powernukkitx.PowerNukkitX \
  --skip-setup --accept-license --language eng