A bunch of game servers I use, dockerised
Switch branches/tags
Nothing to show
Clone or download
Latest commit 11f7da5 Aug 25, 2018
Permalink
Failed to load latest commit information.
7daystodie Make all build scripts tag themselves with a date to avoid untagged i… Feb 4, 2017
armagetron Add RCON_PASSWORD to armagetron Jul 19, 2018
base Make base image build using the common methods Apr 28, 2018
conan-exile Add wine and conan exile server (WIP) Feb 19, 2017
csgo-comp Fix csgo bugs (I think) Apr 27, 2017
csgo-ebot Make all build scripts tag themselves with a date to avoid untagged i… Feb 4, 2017
csgo-gg Make all build scripts tag themselves with a date to avoid untagged i… Feb 4, 2017
csgo-warmod Updated download url Jul 17, 2017
csgo Add way to update CSGO (todo: other steam games) Oct 23, 2017
css-metamod Update README.md Aug 21, 2018
css Add update step to Dockerfile Aug 22, 2018
dont-starve-together Add WIP don't starve together (doesn't work yet) Feb 22, 2017
factorio Fix factorio download URL Apr 28, 2018
hl2dm Fix hl2m not exec'ing Feb 26, 2017
l4d2 Add Left 4 Dead 2 Jul 22, 2018
minecraft Easily override the minecraft version to download Apr 19, 2017
mumble Update mumble readme Feb 19, 2017
openttd Make all build scripts tag themselves with a date to avoid untagged i… Feb 4, 2017
quake-live (Work in progress) add quake live Feb 26, 2017
quake3 Make all build scripts tag themselves with a date to avoid untagged i… Feb 4, 2017
reflex-arena Bug fix reflex map, and update readme Oct 23, 2017
rust (Work in progress) Adds rust Feb 26, 2017
steamcmd Make all build scripts tag themselves with a date to avoid untagged i… Feb 4, 2017
tf2-prophunt Removing map url from tf2 prophunt dockerfile Jul 17, 2017
tf2 Fixes TF2 not running anymore Apr 19, 2017
trackmania-forever-rcon Adds bad implementation of trackmania rcon system Oct 9, 2017
trackmania-forever Fix trackmania tracklists + add pax list Oct 9, 2017
trackmania2 Add WIP Trackmania2 support Feb 22, 2017
unreal4 Fix unreal4 instagib things Oct 27, 2017
wine-src Fix bsh typo and make wine compile to correct directory Feb 19, 2017
wine Add basic reflex arena support Oct 9, 2017
zdaemon Fix zdaemon map bug Oct 23, 2017
.gitignore Adds bad implementation of trackmania rcon system Oct 9, 2017
LICENSE Add license, update readme with a todo Feb 1, 2017
README.md Update readme network section and todo Apr 29, 2017
TODO.md Update readme network section and todo Apr 29, 2017
build.sh Change root build script to always use the folder specific build scripts Apr 19, 2017
common.sh Make base image build using the common methods Apr 28, 2018
dstart.sh Add readme and stuff Nov 15, 2016
settings.sh Change default network to host as we don't auto-create gameserver net… Jan 28, 2017
start_server.sh Fix the start server script makign the wrong directory and restrictiv… Apr 19, 2017

README.md

Putting game servers in Docker containers. Because it makes life easier.

A set of game servers that have been wrapped with Docker. All images are composed of other images in this repository, except for base. Most images will auto-download any dependencies they have (eg, factorio server files or sourcemod for srcds), making it almost one command to install a server. No binaries are stored in this repo, so make sure you have internet to download them with.

Includes a utility script start_server.sh which mounts save data to an external volume and sorts out networking for you.

Quick start

Assuming you are on a blank server with Git and docker installed:

git clone https://github.com/OpenSourceLAN/gameservers-docker.git .
./build.sh factorio

./start_server.sh factorio
# Or
docker run -it --net=host -e "SERVER_NAME=Some really cool server"\
-v `pwd`/save:`cat factorio/mounts` --name factorio factorio

Most servers have environment variables that can be used to configure them. Read the README.md file in each directory to see what is available.

Tutorial

There is a tutorial on the Open Source LAN website which will step you through building and using the images.

Contributions

Contributions are welcome. Submit a pull request or open an issue.

All additions should follow these suggestions:

  • Set up for LAN by default - eg, call +sv_lan 1 in srcds games, but optionally disabling that by runtime var is fine
  • Include a start script that is added to the container, so anyone using the Dockerfile can easily customise their server

Advanced networking stuff

We want to expose all game servers directly to our LAN, and the --host option means we will get port conflicts. There is an alternative approach which uses the ipvlan or macvlan docker network driver.

# Creates a docker network that's bridge with your layer 2 network
# Subnet should match the IP range and subnet of your network.
# ip-range is the CIDR block of IP addresses to assign to containers
# parent is the name of the interface you'd like to bridge containers to

docker network create --driver ipvlan --subnet=10.0.0.0/24 -o parent=eth0 --ip-range 10.0.0.16/28 --gateway 10.0.0.1  gameservers

# If the above command doesn't work, try using macvlan instead of ipvlan

# Starts your game server inside the layer 2 network
docker run -it --rm --net=gameservers csgo /steam/csgo/srcds_run -game csgo +sv_lan 1 +map cs_office

You can now see the CSGO server from another server on your network.

Running game servers on Docker Swarm

These are the instructions for building a swarm.

In addition to the swarm, one also needs a docker registry (I think).

These are the following gotchas that you need to be aware of:

  • If using ipvlan, you need experimental, not main release docker (as at version 1.12)
  • The ipvlan network is local scoped. This means you need to create the network on every host individually. You should ensure the assigned IP ranges for each host do not overlap, as there does not appear to be any shared state about IP addresses assigned. The name of the networks should be identical on every host.
  • The tutorial only has you set up a single consul instance. It will change IP addresses every time the container restarts, and this will cause consul to fail because it cannot elect itself leader, since it thinks another instance exists at a different IP address. Make sure to hard code an IP for it.
  • Using ubuntu 14.04, you'll need to update /etc/defaults/docker to contain: DOCKER_OPTS="-H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock"
  • If not using a secured docker registry, also add to the DOCKER_OPTS value: --insecure-registry=registry-hostname:5000
  • Consul, docker node and docker masters can all be on the same host (I think - it works for me at least)
  • To get a container to failover between hosts in the case of an outage, you need to run the container with these args: -e reschedule:on-node-failure (todo: figure out why the container doesn't get auto-started on the new host). Also note that a race condition exists - when the host comes back up, it will start the old container, and when the docker swarm manager container starts, it will detect the container was moved and kill it.

Setting up multiple consul hosts

Run the master like this:

docker run -d  -v /mnt:/data --name consul \
    -p 8300:8300 \
    -p 8301:8301 \
    -p 8301:8301/udp \
    -p 8302:8302 \
    -p 8302:8302/udp \
    -p 8400:8400 \
    -p 8500:8500 \
    -p 53:53/udp \
    progrium/consul -server -advertise 10.0.0.167 -bootstrap-expect 3

and the other two like this:

    docker run -d -v /mnt:/data --name consul \
    -p 8300:8300 \
    -p 8301:8301 \
    -p 8301:8301/udp \
    -p 8302:8302 \
    -p 8302:8302/udp \
    -p 8400:8400 \
    -p 8500:8500 \
    -p 53:53/udp \
    progrium/consul -server -advertise 10.0.0.197 -join 10.0.0.167

Double check all 3 are present in cluster by doing curl http://localhost:8500/v1/status/peers.

TODO

Ensure every instance has:

  • A README covering available options, startup scripts, etc
  • Auto-mount point support where appropriate (eg, for saves, demos)
  • Config options for at least:
    • The name of the server (what it shows as in server browsers)
    • Server password
    • RCON password (where RCON exists)
    • LAN or internet
  • Has dockerfile configured with default ports it exposes (not that the suggested configuration uses these)
  • Has a way to easily RCON or remote control
  • Does not require user to manually download everything (with exceptions for some large and customisable downloads)
  • Fix the thing where the auto mounts always have permission problems because conatiners

Make the easy start script support passing environment variables to the container

Make an easy way to import config files in to the servers (eg mounting cfg directories)

Add more games

LICENSE

This project is licensed under GPL 3.0. See LICENSE for more information.