README.md

ARK: Survival Evolved Dedicated Server

Disclaimer

Note: This image is not officially supported by Valve, nor by Studio Wildcard.

If issues are encountered, please report them on the GitHub repository

Badges

Description

Dedicated Server for ARK: Survival Evolved using Docker, and optionally Docker-Compose.
Built almost from scratch to be the smallest ARK: Survival Evolved Dedicated Server around!

Links

Source:

• GitHub
• DockerHub

Resource links:

• Dedicated Server Setup
• Dedicated Server Configuration
• Steam DB Page

Instructions

The server can be run using plain Docker, or using Docker-Compose. The end-result is the same, but Docker-Compose is recommended.

Optional arguments table:

Argument	Description	Values	Default
ADMIN_PASSWORD	Server Admin account password	[a-zA-Z0-9]+	changeme
GAME_PORT	Port for sending game data to clients	1000 - 65535	7777
GAME_PORT_2	Additionally required Port for sending game data to clients	1000 - 65535	7778
GAME_VERSION	Game version to serve	[a-zA-Z0-9_]+	public
MAP_NAME	Set the map to be loaded	[a-zA-Z]+	TheIsland
MAX_PLAYERS	Maximum players allowed in the Server	[0-9]+	16
QUERY_PORT	Port for other players to connect to	1000 - 65535	27015
SERVER_NAME	Publicly visible Server Name	[a-zA-Z0-9]+	ArkSeServer
SERVER_PASSWORD	Server password	[a-zA-Z0-9]+

Docker

The following are instructions for running the server using the Docker image.

1. Acquire the image locally:

   • Pull the image from DockerHub:

     docker pull renegademaster/ark-se-dedicated-server:<tagname>

   • Or alternatively, build the image:

     git clone https://github.com/Renegade-Master/ark-se-dedicated-server.git \
         && cd ark-se-dedicated-server
     
     docker build -t renegademaster/ark-se-dedicated-server:<tag> -f docker/ark-se-dedicated-server.Dockerfile .

2. Run the container:

   Note: Arguments inside square brackets are optional. If the default ports are to be overridden, then the published ports below must also be changed

   mkdir -p ArkSE_Install/ShooterGame/Saved ArkSE_Config
   
   docker run --detach \
       --mount type=bind,source="$(pwd)/ArkSE_Install",target=/home/steam/ArkSE_Install \
       --mount type=bind,source="$(pwd)/ArkSE_Config",target=/home/steam/ArkSE_Install/ShooterGame/Saved \
       --publish 27015:27015/udp --publish 7777:7777/udp --publish 7778:7778/udp \
       --ulimit nofile=1000000:1000000 \
       --name ark-se-server \
       --user=$(id -u):$(id -g) \
       [--env=ADMIN_PASSWORD=<value>] \
       [--env=GAME_PORT=<value>] \
       [--env=GAME_PORT_2=<value>] \
       [--env=GAME_VERSION=<value>] \
       [--env=MAP_NAME=<value>] \
       [--env=MAX_PLAYERS=<value>] \
       [--env=QUERY_PORT=<value>] \
       [--env=SERVER_NAME=<value>] \
       [--env=SERVER_PASSWORD=<value>] \
       renegademaster/ark-se-dedicated-server[:<tagname>]

3. Once you see Setting breakpad minidump AppID = 346110 in the console, people can start to join the server.

Docker-Compose

The following are instructions for running the server using Docker-Compose.

1. Download the repository:

   git clone https://github.com/Renegade-Master/ark-se-dedicated-server.git \
       && cd ark-se-dedicated-server

2. Make any configuration changes you want to in the docker-compose.yaml file. In the services.ark-se-server.environment section, you can change values for the server configuration.

   Note: If the default ports are to be overridden, then the published ports must also be changed

3. In the docker-compose.yaml file, you must change the services.ark-se-server.user values to match your local user. To find your local user and group ids, run the following command:

   printf "UID: %s\nGID: %s\n" $(id -u) $(id -g)

4. Run the following commands:

   mkdir -p ArkSE_Install/ShooterGame/Saved ArkSE_Config
   
   docker-compose up --build --detach

5. Once you see Setting breakpad minidump AppID = 346110 in the console, people can start to join the server.