Skip to content

Latest commit

 

History

History
134 lines (94 loc) · 5.82 KB

README.md

File metadata and controls

134 lines (94 loc) · 5.82 KB

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

Build and Test Server Image

Docker Image Version (latest by date) Docker Image Size (latest by date) Docker Pulls

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:

Resource links:

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.