hoellenwesen/docker-ark-dedicated-server

ARK: Survival Evolved dedicated server running in a docker container

ARK: Survival Evolved Dedicated Server - Docker

Docker build for managing an ARK: Survival Evolved server.

This image uses Ark Server Tools to manage an ark server.

Features

• Easy install (no steamcmd / lib32... to install)
• Use Ark Server Tools : update/install/start/backup/rcon/mods
• Easy crontab configuration
• Easy access to ark config file
• Mods handling (via Ark Server Tools)
• Docker stop is a clean stop

Usage

Fast & Easy server setup :
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -e SESSIONNAME=myserver -e ADMINPASSWORD="mypasswordadmin" --name Ark ghcr.io/hoellenwesen/docker-ark-dedicated-server:latest

You can map the ark volume to access config files :
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -e SESSIONNAME=myserver -v /my/path/to/ark:/ark --name Ark ghcr.io/hoellenwesen/docker-ark-dedicated-server:latest
Then you can edit /my/path/to/ark/arkmanager.cfg (the values override GameUserSetting.ini) and /my/path/to/ark/[GameUserSetting.ini/Game.ini]

You can manager your server with rcon if you map the rcon port (you can rebind the rcon port with docker):
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -p 32330:32330 -e SESSIONNAME=myserver --name Ark ghcr.io/hoellenwesen/docker-ark-dedicated-server:latest

You can change server and steam port to allow multiple servers on same host:
(You can't just rebind the port with docker. It won't work, you need to change STEAMPORT & SERVERPORT variable) docker run -d -p 7779:7779 -p 7779:7779/udp -p 27016:27016 -p 27016:27016/udp -p 32331:32330 -e SESSIONNAME=myserver2 -e SERVERPORT=27016 -e STEAMPORT=7779 --name Ark2 ghcr.io/hoellenwesen/docker-ark-dedicated-server:latest

You can check your server with :
docker exec Ark arkmanager status

You can manually update your mods:
docker exec Ark arkmanager update --update-mods

You can manually update your server:
docker exec Ark arkmanager update --force

You can force save your server :
docker exec Ark arkmanager saveworld

You can backup your server :
docker exec Ark arkmanager backup

You can upgrade Ark Server Tools :
docker exec Ark arkmanager upgrade-tools

You can use rcon command via docker :
docker exec Ark arkmanager rconcmd ListPlayers
Full list of available command here

You can check all available command for arkmanager here

You can easily configure automatic update and backup.
If you edit the file /my/path/to/ark/crontab you can add your crontab job.
For example :
# Update the server every hours
0 * * * * arkmanager update --warn --update-mods >> /ark/log/crontab.log 2>&1
# Backup the server each day at 00:00
0 0 * * * arkmanager backup >> /ark/log/crontab.log 2>&1
You can check this website for more information on cron.

To add mods, you only need to change the variable ark_GameModIds in arkmanager.cfg with a list of your modIds (like this ark_GameModIds="987654321,1234568"). If UPDATEONSTART is enable, just restart your docker or use docker exec ark arkmanager update --update-mods.

---

Recommended Usage

• First run
  docker run -it -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -p 32330:32330 -e SESSIONNAME=myserver -e ADMINPASSWORD="mypasswordadmin" -e AUTOUPDATE=120 -e AUTOBACKUP=60 -e WARNMINUTE=30 -v /my/path/to/ark:/ark --name Ark ghcr.io/hoellenwesen/docker-ark-dedicated-server:latest
• Wait for ark to be downloaded installed and launched, then Ctrl+C to stop the server.
• Edit /my/path/to/ark/GameUserSetting.ini and Game.ini
• Edit /my/path/to/ark/arkserver.cfg to add mods and configure warning time.
• Add auto update every day and autobackup by editing /my/path/to/ark/crontab with this lines :
  0 0 * * * arkmanager update --warn --update-mods >> /ark/log/crontab.log 2>&1
0 0 * * * arkmanager backup >> /ark/log/crontab.log 2>&1
• docker start ark
• Check your server with :
  docker exec Ark arkmanager status

---

Variables

• SESSIONNAME Name of your ark server (default : "Ark Docker")
• SERVERMAP Map of your ark server (default : "TheIsland")
• SERVERPASSWORD Password of your ark server (default : "")
• SERVERMODS Comma delimited list of server mods
• NBPLAYERS Number of players that can connect to the Ark server
• ADMINPASSWORD Admin password of your ark server (default : "adminpassword")
• SERVERPORT Ark server port (can't rebind with docker, it doesn't work) (default : 27015)
• STEAMPORT Steam server port (can't rebind with docker, it doesn't work) (default : 7778)
• BACKUPONSTART 1 : Backup the server when the container is started. 0: no backup (default : 1)
• UPDATEPONSTART 1 : Update the server when the container is started. 0: no update (default : 1)
• BACKUPONSTOP 1 : Backup the server when the container is stopped. 0: no backup (default : 0)
• WARNONSTOP 1 : Warn the players before the container is stopped. 0: no warning (default : 0)
• TZ Time Zone : Set the container timezone (for crontab). (You can get your timezone posix format with the command tzselect. For example, France is "Europe/Paris").
• UID UID of the user used. Owner of the volume /ark
• GID GID of the user used. Owner of the volume /ark

---

Volumes

• /ark : Working directory :
  • /ark/server : Server files and data.
  • /ark/log : logs
  • /ark/backup : backups
  • /ark/arkmanager.cfg : config file for Ark Server Tools
  • /ark/crontab : crontab config file
  • /ark/Game.ini : ark game.ini config file
  • /ark/GameUserSetting.ini : ark gameusersetting.ini config file
  • /ark/template : Default config files
  • /ark/template/arkmanager.cfg : default config file for Ark Server Tools
  • /ark/template/crontab : default config file for crontab
  • /ark/staging : default directory if you use the --downloadonly option when updating.

---

Expose

• Port : STEAMPORT : Steam port (default: 7778)
• Port : SERVERPORT : server port (default: 27015)
• Port : 32330 : rcon port

---

Known issues

docker-ark-dedicated-server's Issues

connection time out?

This seems like a great package with lots of nice documentation/presentation and the install process was clear (although it took quite a while). it is all running and the status comes back as all ok and it shows up as ready and open in steam and on BattleMetrics. However, I cannot connect from Steam on a PC to my dedicated server (on docker) using this -- I keep getting "Joining Failed. Connection Timeout."
Any ideas on how to remedy this issue? Thanks.