TES3MP/server-container

Container image for the TES3MP server.

Available for linux/amd64 and linux/arm/v7.

Container registry

https://hub.docker.com/r/tes3mp/server/

Configuration

Values can be passed into the server configuration file via environment variables.

On startup the container will look for any environment variables prefixed by TES3MP_SERVER_ and attempt to update them on tes3mp-server-default.cfg.

Environment variables should be represented as uppercase snake case.

For example TES3MP_SERVER_MAXIMUM_PLAYERS correlates to maximumPlayers in the configuration file.

Getting the image

Pulling from registry

Pull the latest stable version

docker pull tes3mp/server

Pull a specific version

docker pull tes3mp/server:0.6.3

Building

git clone https://github.com/GrimKriegor/TES3MP-container.git
cd TES3MP-container
git checkout <TES3MP version> # optional
docker build -t tes3mp/server:<TES3MP version> .

Running

There is no need to pull the image when running the container through one of the methods described below.

Replace the path described at the -v (volume) argument to a directory on your machine you already have, or wish to have compatible server data and scripts. Keep the path that comes after the colon, as its the internal container path to where server data should be.

Run the latest stable version

docker run -it \
    --name TES3MP-server \
    -e TES3MP_SERVER_HOSTNAME="Containerized TES3MP Server" \
    -v "$HOME/TES3MP/data:/server/data" \
    -p "25565:25565/udp" \
    tes3mp/server

Run a specific version

docker run -it \
    --name TES3MP-server \
    -e TES3MP_SERVER_HOSTNAME="Containerized TES3MP Server" \
    -v "$HOME/TES3MP/data:/server/data" \
    -p "25565:25565/udp" \
    tes3mp/server:0.6.3

Run in the background

Same as above, but removing the -it arguments.

And to later attach the console:

docker attach TES3MP-server

Compose file

Alternatively you can use a compose file to deploy one or more servers as a stack.

Create a file titled docker-compose.yml with the following contents:

version: '3'
services:
  server:
    image: "tes3mp/server:0.6.3"
    environment:
      - TES3MP_SERVER_HOSTNAME="Containerized TES3MP Server"
    volumes:
      - "./data:/server/data"
    ports:
      - "25565:25565/udp"
# Optional extra servers:
  server-legacy:
    image: "tes3mp/server:0.5.2"
    environment:
      - TES3MP_SERVER_HOSTNAME="Containerized TES3MP Server (Legacy)"
    volumes:
      - "./data-legacy:/server/data"
    ports:
      - "25566:25565/udp"

Deploy it locally

docker-compose up

Deploy it on a swarm cluster

docker stack deploy -c docker-compose.yml tes3mp-server-stack