This is a Docker image of Travertine and is intended to be used at the front-end of a cluster of itzg/minecraft-server containers.

Using with itzg/minecraft-server image

When using with the server image itzg/minecraft-server you can disable online mode, which is required by bungeecord, by setting ONLINE_MODE=FALSE, such as

docker run ... -e ONLINE_MODE=FALSE itzg/minecraft-server

Here is an example Docker Compose file.

Environment Settings

• BUNGEE_JOB_ID=lastStableBuild

  The Jenkins job ID of the artifact to download and run and is used when deriving the default value of BUNGEE_JAR_URL

• BUNGEE_BASE_URL=https://papermc.io/ci/job/Travertine

  Used to derive the default value of BUNGEE_JAR_URL

• BUNGEE_JAR_URL=${BUNGEE_BASE_URL}/${BUNGEE_JOB_ID}/artifact/Travertine-Proxy/bootstrap/target/Travertine.jar

  If set, can specify a custom, fully qualified URL of the Travertine.jar

• MEMORY=512m

  The Java memory heap size to specify to the JVM.

• INIT_MEMORY=${MEMORY}

  Can be set to use a different initial heap size.

• MAX_MEMORY=${MEMORY}

  Can be set to use a different max heap size.

• JVM_OPTS

  Additional -X options to pass to the JVM.

Volumes

• /server

  The working directory where BungeeCord is started. This is the directory where its config.yml will be loaded.

• /plugins

  Plugins will be copied across from this directory before the server is started.

• /config

  The /config/config.yml file in this volume will be copied accross on startup if it is newer than the config in /server/config.yml.

Ports

• 25577

  The listening port of BungeeCord, which you will typically want to port map to the standard Minecraft server port of 25565 using:

  -p 25565:25577
  

BungeeCord Configuration

BungeeCord Configuration Guide

Scenarios

Running non-root

This image may be run as a non-root user but does require an attached /server volume that is writable by that uid, such as:

docker run ... -u $uid -v $(pwd)/data:/server ninjawulf98/travertine