GuillaumeHemmen/Ark-docker
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Ark-docker/README.md
TuRz4m e8514fe155 Update README.md
2015-10-27 10:43:55 +01:00

5 KiB
Raw Blame History

ARK: Survival Evolved - Docker

Docker build for managing an ARK: Survival Evolved server.

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

If you use an old volume, delete arkmanager.cfg to get the new configuration file.

Features

  • Easy install (no steamcmd / lib32... to install)
  • Use Ark Server Tools : update/install/start/backup/rcon
  • Auto update (on start or on timer)
  • Auto backup (on start or on timer)
  • 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 turzam/ark

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 turzam/ark
Then you can edit /my/path/to/ark/arkcmanager.cfg (the values override GameUserSetting.ini) and /my/path/to/ark/server/ShooterGame/Saved/Config/LinuxServer/[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 turzam/ark

You can define a server that updates itself every 2 hours (with 1 hour warning) and backups itself every hours:
docker run -d -p 7778:7778 -p 7778:7778/udp -p 27015:27015 -p 27015:27015/udp -e SESSIONNAME=myserver -e AUTOBACKUP=60 -e AUTOUPDATE=120 -e WARNMINUTE=60 --name ark turzam/ark

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 turzam/ark

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

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

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 turzam/ark
  • Wait for ark to be downloaded installed and launched, then Ctrl+C to stop the server.
  • Modify /my/path/to/ark/server/ShooterGame/Saved/Config/LinuxServer/GameUserSetting.ini and Game.ini
  • 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 : "")
  • 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)
  • AUTOUPDATE Number of minute between each check for une newer version (-1 disable auto update) (default : -1) Auto update is set to --warn and warn the players 30 minutes before update (default, can be changed in /ark/arkmanager.cfg).
  • AUTOBACKUP Number of minute between each backup (-1 disable auto backup) (default : -1)
  • WARNMINUTE Number of minute to warn the players when auto-update (default : 30)

Volumes

  • /ark : Working directory :
    • /ark/server : Server files and data.
    • /ark/log : logs
    • /ark/backup : backups
    • /ark/arkmanager.cfg : config file

Expose

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

Known issues

Changelog

  • 1.0 :
    • Initial image : works with Ark Server tools 1.3
    • Add auto-update & auto-backup
  • 1.1 :