Skip to content
BlueDragon Docs

Deploying with Docker

This guide will walk you through deploying BlueDragon with Docker.

Prerequisites

Configuration

Before you run BlueDragon’s Docker containers, you must have:

  • A world folder (in /data/worlds)
  • A songs folder (in /data/songs, optional)
  • A buffer-config.properties file
  • A proxy-config.properties file

World folder

The /data/worlds directory should be configured as documented here.

Songs folder

To play note block songs, add .nbs files created with Note Block Studio to a songs directory. These are mounted into the container at /proxy/plugins/bluedragon-jukebox/songs/. You should be able to see the songs by typing /play in-game.

Running

Creating a network

Before you start up any containers, you need to create a Docker network to allow containers to communicate with MongoDB without exposing all their ports to the host (i.e. with --net host).

Terminal window
docker network create bluedragon-network

When starting containers, we will use the --network option to add them to this network.

MongoDB

Terminal window
docker run -d -p 27017:27017 -v bluedragon_mongo_data:/data/db --net bluedragon-network --network-alias mongo mongo

LuckPerms

Terminal window
docker run -d \
  -p 8080:8080 \
  -e LUCKPERMS_STORAGE_METHOD=mongodb \
  -e LUCKPERMS_DATA_MONGODB_CONNECTION_URI="mongodb://mongo:27017/" \
  -e LUCKPERMS_DATA_DATABASE=luckperms \
  --net bluedragon-network \
  ghcr.io/luckperms/rest-api

Puffin

Terminal window
git clone https://github.com/BlueDragonMC/Puffin
cd Puffin
docker build -t bluedragonmc/puffin:latest .
docker run -d \
  -v /data/worlds:/data/worlds \
  -v buffer-config.properties:/service/config/buffer-config.properties \
  -e PUFFIN_DEV_MODE=true \
  -e PUFFIN_WORLD_FOLDER=/data/worlds \
  -e PUFFIN_MONGO_CONNECTION_STRING=mongodb://mongo:27017 \
  -e PUFFIN_LUCKPERMS_URL=http://luckperms:8080 \
  -e PUFFIN_DEFAULT_GAMESERVER_IP=minecraft \
  -e PUFFIN_DEFAULT_PROXY_IP=proxy \
  --net bluedragon-network \
  bluedragonmc/puffin:latest

Proxy

Terminal window
git clone https://github.com/BlueDragonMC/Komodo
cd Komodo
docker build -t bluedragonmc/komodo:latest .
docker run -d \
  -v /data/songs:/proxy/plugins/bluedragon-jukebox/songs/ \
  -e PUFFIN_VELOCITY_SECRET=<your velocity secret> \
  --net bluedragon-network \
  bluedragonmc/komodo:latest

Minecraft Server

Terminal window
git clone https://github.com/BlueDragonMC/Server
cd Server
docker build -t bluedragonmc/server:latest .
docker run \
  -v /data/worlds:/data/worlds \
  -v ./games:/server/games \
  -e BLUEDRAGON_QUEUE_TYPE=IPC \
  -e BLUEDRAGON_MONGO_CONNECTION_STRING=mongodb://mongo:27017 \
  -e BLUEDRAGON_PUFFIN_HOSTNAME=puffin \
  -e BLUEDRAGON_LUCKPERMS_HOSTNAME=http://luckperms:8080 \
  -e BLUEDRAGON_DEFAULT_GAME=lobby \
  -e BLUEDRAGON_AGONES_DISABLED=true \
  -e PUFFIN_VELOCITY_SECRET=<your velocity secret> \
  --net bluedragon-network \
  bluedragonmc/server:latest

Permissions

By default, LuckPerms does not give any permissions to anyone. To give yourself permissions, run the following command in a terminal:

Terminal window
docker run --rm -it -e LUCKPERMS_STORAGE_METHOD=mongodb -e LUCKPERMS_DATA_MONGODB_CONNECTION_URI="mongodb://localhost:27017/" -e LUCKPERMS_DATA_DATABASE=luckperms --net host ghcr.io/luckperms/rest-api

Then, when you see the prompt, type in lp user <your username> permission set * true. This will give you every permission. You may need to log in to the Minecraft server before running this command.

After you change permissions this way, you must restart your standalone LuckPerms instance for the change to take effect.