arma3-docker/README

78 lines
2.7 KiB
Plaintext
Raw Permalink Normal View History

2019-04-11 22:55:53 +02:00
# Arma 3 server Dockerfile
2019-04-11 22:58:17 +02:00
# Forked from https://github.com/poooldo/arma3server.git
# modified
2019-04-11 22:55:53 +02:00
## Introduction
This dockerfile install Steam CLI and download Arma 3 server content and execute it.
The container needs two environment variables to work properly:
```
STEAM_LOGIN
STEAM_PASSWORD
```
containing the login and password to connect to a steam account.
Because it use a volume to store the Steam and Arma 3 data, you will need to create a directory on the host filesystem to bind the volume.
## Building from source
To build from source you need to clone the git repo and run docker build:
```
2019-04-11 22:59:28 +02:00
git clone https://git.scytec.de/danthefan/arma3-docker.git
cd arma3-docker
2019-04-11 22:55:53 +02:00
docker build -t arma3server .
```
## Running
First, you need to create the mountpoint used by the docker volume (I use /home/steam but you can change this accordingly in the Dockerfile):
```
# mkdir /home/steam
# chown 2000:2000 /home/steam/
```
**Note:** We use 2000 as uid/guid which is the same when creating the steam user in the container. We will need around 2GB of memory to download Arma 3 content.
Run the container using root or sudo:
```
docker run -e STEAM_LOGIN='your_steam_login' -e STEAM_PASSWORD='your_steam_password' -p 0.0.0.0:2302:2302/udp -v /home/steam:/home/steam -d -t arma3server
```
After the first run, the arma3 won't be touched. To manually tells the container you want to update all ARMA3 data, just declare $ARMA3_UPDATE_DATA on the next container run.
## Customizing server.cfg
In this vanilla version, Arma 3 server.cfg is a basic configuration file. You need to define $ARMA3_SERVER_CFG to overload its behavior.
You can also define $SERVER_UPDATE_PASSWORD when running the container to generate automatic random password for admin and command. These passwords will be printed into the logs.
## Running Mods
To create a new image running a specific mod:
- create an image based on this one.
- add a script setting up things for the mod (ADD mymod.sh /tmp/mymod.sh)
- declare $MOD_SCRIPT pointing to the setup script (ENV MOD_SCRIPT /tmp/mymod.sh)
- overload server.cfg by adding yours (ADD server.cfg /tmp/server.cfg)
- install needed services (i.e. MySQL,...)
As soon as AltisLife image is pushed, you'll got an example.
## Logging
All logs print out in stdout/stderr and are available via the docker logs command:
```
docker logs <CONTAINER_NAME>
```
If everything works fine (after start.sh has finished to download Steam and Arma 3), you should see something like:
```
15:36:29 Game Port: 2302, Steam Query Port: 2303
15:36:29 Initializing Steam server - Game Port: 2302, Steam Query Port: 2303
Arma 3 Console version 1.54 : port 2302
15:36:30 Connected to Steam servers
```
## Versions
- GNU/Linux Debian Jessie: **8.x**