U3DS Docker Image

This Docker image contains a dedicated server for the free-to-play survival game Unturned. This image uses CM2Walki's steamcmd image as a base.

Source

The source can be found on GitHub.

Running the Image

Running on the host interface:

$ docker run -d --net=host --name=u3ds dakskihedron/u3ds

Running using a bind mount for data persistence on container recreation:

$ mkdir -p $(pwd)/u3ds
$ chmod 777 $(pwd)/u3ds # Makes sure the directory is writable by the unprivileged container user
$ docker run -d --net=host -v $(pwd)/u3ds:/home/steam/u3ds/ --name=u3ds dakskihedron/u3ds

Configuration

Environment Variables

The Dockerfile defines the following environment variables:

INTERNET_SERVER=false
SERVER_ID="Default"
STEAM_BETA_BRANCH=""

• INTERNET_SERVER determines whether to run the server locally (default) or on the internet (for publicly-accessible servers). To run the server on the internet, pass the following:

  -e INTERNET_SERVER=true

  Note: additional setup is required to make the server visible on the server list. Refer to the official documentation for more details.

• SERVER_ID determines the name of the server directory. By default, the server directory will be named Default; the level data, config files, etc will be found under u3ds/Servers/Default. To change the name, pass the following:

  -e SERVER_ID="new_server_name"

• STEAM_BETA_BRANCH allows you to install a beta branch. An empty entry defaults to the release branch. To install a beta branch, pass the following:

  -e STEAM_BETA_BRANCH="name_of_branch"

Server Files and Configs

To access the dedicated server within the Docker container:

$ docker exec -it -w /home/steam/u3ds u3ds bash

This will allow bash access to the dedicated server in container. The level data, config files, etc for the server can be found under Servers/[SERVER_ID].

For ease of access, it may be preferable to run the image with a bind mount instead, so the dedicated server can be access directly from the filesystem.

If you want to learn more about configuring an Unturned dedicated server, check out the official documentation. For a list of commands, check this wiki page.

Acknowledgements

@CM2Walki - For Dockerising SteamCMD and various gameservers, which inspired me to make my own image.