• This repository has been archived on 28/Oct/2023
  • Stars
    star
    121
  • Rank 293,924 (Top 6 %)
  • Language
    Shell
  • License
    MIT License
  • Created almost 7 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Docker image for a dedicated ARK Server with ArkManager.

Travis CI Build Status Docker Build Status Docker Pulls License

arkserver

Docker image for a dedicated ARK Server with arkmanager.

Overview

This is an image for running an ARK: Survival Evolved server in a Docker container. It is heavily based off of TuRz4m's work located here: TuRz4m/Ark-docker. It uses FezVrasta's arkmanager (ark-server-tools) to managed a single-instance ARK: Survival Evolved server inside a docker container.

This image inherits from the thmhoag/steamcmd image to include the latest version of steamcmd.

For more information on arkmanager, see the repo here: https://github.com/FezVrasta/ark-server-tools

Features

  • Automated install (pull the image and run, no additional commands necessary)
  • Configuration via Environment Variables
  • Easy crontab manipulation for automated backups, updates, daily restarts, weekly dino wipes, etc
  • Simple volume structure for server files, config, logs, backups, etc
  • Inherently includes all features present in arkmanager

Tags

Tag Description
latest most recent build from the master branch
x.x.x (semver) release builds

Usage

Installing the image

Pull the latest (or any other desired version):

docker pull thmhoag/arkserver:latest

Running the server

To run a generic server with no configuration modifications:

$ docker run -d \
    -v steam:/home/steam/Steam \  # mounted so that workshop (mod) downloads are persisted
    -v ark:/ark \  # mounted as the directory to contain the server/backup/log/config files
    -p 27015:27015 -p 27015:27015/udp \  # steam query port
    -p 7778:7778 -p 7778:7778/udp \  # gameserver port
    -p 7777:7777 -p 7777:7777/udp \ # gameserver port
    thmhoag/arkserver

If the exposed ports are modified (in the case of multiple containers/servers on the same host) the arkmanager config will need to be modified to reflect the change as well. This is required so that arkmanager can properly check the server status and so that the ARK server itself can properly publish its IP address and query port to steam.

Environment Variables

A set of required environment variables have default values provided as part of the image:

Variable Value Description
am_ark_SessionName Ark Server Server name as it will show on the steam server list
am_serverMap TheIsland Game map to load
am_ark_ServerAdminPassword k3yb04rdc4t Admin password to be used via ingame console or RCON
am_ark_MaxPlayers 70 Max concurrent players in the game
am_ark_QueryPort 27015 Steam query port (allows the server to show up on the steam list)
am_ark_Port 7778 Game server port (allows clients to connect to the server)
am_ark_RCONPort 32330 RCON port
am_arkwarnminutes 15 Number of minutes to wait/warn players before updating/restarting
am_arkflag_crossplay false Allow crossyplay with Players on Epic

Adding Additional Variables

Any configuration value that is available via arkmanager can be set using an environment variable. This works by taking any environment variable on the container that is prefixed with am_ and mapping it to the corresponding environment variable in the arkmanager.cfg file.

For a complete list of configuration values available, please see FezVrasta's great documentation here: arkmanager Configuration Files

Volumes

This image has two main volumes that should be mounted as named volumes or host directories for the persistence of the server install and all related configuration files. More information on Docker volumes here: Docker: Use Volumes

Path Description
/home/steam/Steam Directory of steam cache and other steamcmd-related files. Should be mounted so that mod installs are persisted between container runs/restarts
/ark Directory that will contain the server files, config files, logs and backups. More information below

Subdirectories of /ark

Inside the /ark volume there are several directories containing server related files:

Path Description
/ark/backup Location of the zipped backups genereated from the arkmaanger backup command. Compressed using bz2.
/ark/config Location of server config files. More information:
/ark/log Location of the arkmanager and arkserver log files
/ark/server Location of the server installation performed by steamcmd. This will contain the ShooterGame directory and the actual server binaries.
/ark/staging Default directory for staging game and mod updates. Can be changed using in arkmanager.cfg