Skip to content

ARK: Survival Ascended

ARK is reimagined from the ground-up into the next-generation of video game technology with Unreal Engine 5! Form a tribe, tame & breed hundreds of unique dinosaurs and primeval creatures, explore, craft, build, and fight your way to the top of the food-chain. Your new world awaits!

egg-ark-survival-ascended.json

updated

Ports

Add an allocation on the node for each port.

  • Game 7777
  • RCON (optional) 37015

Install

Installer image
ghcr.io/ptero-eggs/installers:debian
Steam app
2430930
Steam login
not required
Install script
70 lines

Image

  • Proton ghcr.io/ptero-eggs/steamcmd:proton

Panel features

  • steam_disk_space

    The Panel tells the user when SteamCMD does not have enough disk space.

Startup

The Panel runs this command to start the server. It replaces each variable in the command with the value of that variable.

13 variables

Startup command

rmv() { echo "stopping server"; rcon -t rcon -a 127.0.0.1:37015 -p {{ARK_ADMIN_PASSWORD}} KeepAlive && rcon -t rcon -a 127.0.0.1:37015 -p {{ARK_ADMIN_PASSWORD}} DoExit && wait ${ARK_PID}; echo "Server Closed"; exit; }; trap rmv 15 2; proton run ./ShooterGame/Binaries/Win64/ArkAscendedServer.exe TheIsland_WP?listen?MaxPlayers=70?SessionName=\"A Pterodactyl Hosted Server\"?Port=7777?RCONPort=37015?RCONEnabled=True$( [  "1" == "0" ] || printf %s '?ServerPVE=True' )?ServerPassword="{{SERVER_PASSWORD}}"{{ARGS_PARAMS}}?ServerAdminPassword="{{ARK_ADMIN_PASSWORD}}" -WinLiveMaxPlayers=70 -oldconsole -servergamelog $( [ -z "{{MOD_IDS}}" ] || printf %s ' -mods=' {{MOD_IDS}} )$( [ "1" == "1" ] || printf %s ' -NoBattlEye' ) -Port=7777 {{ARGS_FLAGS}} & ARK_PID=$! ; tail -c0 -F ./ShooterGame/Saved/Logs/ShooterGame.log --pid=$ARK_PID & until echo "waiting for rcon connection..."; (rcon -t rcon -a 127.0.0.1:37015 -p {{ARK_ADMIN_PASSWORD}})<&0 & wait $!; do sleep 5; done

Dotted values come from the server settings. These values are examples.

  • Available Maps: TheIsland_WP

    SERVER_MAPUsers can edit

    required|string|max:64

  • "Unofficial" dedicated server name

    SESSION_NAMEUsers can edit

    required|string|max:256

  • This is to enable auto-updating for servers on restart/re-install.

    AUTO_UPDATEUsers can edit

    required|boolean

  • Enable BattleEye / Anti-Cheat

    BATTLE_EYEUsers can edit

    required|boolean

  • app id required for server download/updates. end users should not see this.

    SRCDS_APPIDUsers cannot see

    required|integer|in:2430930

  • params (?ServerPassword=...) are supported here but params need to be touching. (i.e): ?ServerPassword=MyP4SsWoRd?ServerAdminPassword=sUpRp4ssW0rd

    ARGS_PARAMSUsers can edit

    nullable|string|max:1024

  • Specifies the maximum amount of players able to join the server.

    MAX_PLAYERSUsers can edit

    required|integer|min:1|max:200

  • Used for RCON (remote and in-browser console) as well as in-game EnableCheats

    ARK_ADMIN_PASSWORDUsers can edit

    required|alpha_dash|max:128A value is required.

  • flags (-UseBattleEye) are supported here without them touching. (i.e): -crossplay -mods=1234,1235,1236

    ARGS_FLAGSUsers can edit

    nullable|string|max:1024

  • ON = Player-vs-Environment (PvE), OFF = Player-vs-Player (PvP); Default is ON

    SERVER_PVEUsers can edit

    required|boolean

  • required password to enter the server, leave blank for public server

    SERVER_PASSWORDUsers can edit

    nullable|alpha_dash|max:128

  • required for console commands and proper server shutdown (saveworld/exit), doesn't have to be open to the public

    RCON_PORTUsers can see

    required|integer|min:1025|max:65535

  • https://www.curseforge.com/ark-survival-ascended ; ProjectID is is the MOD_ID on the right-side of the mod-view page ; leave blank to disable mods ; separate only by comma ( , ) without spaces! (i.e.) 1234,1235,1236

    MOD_IDSUsers can edit

    nullable|string|max:512

Wings

Stop command
^C (SIGINT)
Running when the console shows
Waiting commands for 127.0.0.1:

Files Wings edits

Wings sets these values in these files before each start.

ShooterGame/Saved/Config/WindowsServer/GameUserSettings.ini file

MaxPlayers=
MaxPlayers={{server.build.env.MAX_PLAYERS}}
ServerAdminPassword=
ServerAdminPassword={{server.build.env.ARK_ADMIN_PASSWORD}}

Readme

ARK: Survival Ascended

Steam Description : ARK is reimagined from the ground-up into the next-generation of video game technology with Unreal Engine 5! Form a tribe, tame & breed hundreds of unique dinosaurs and primeval creatures, explore, craft, build, and fight your way to the top of the food-chain. Your new world awaits!

Authors / Contributors


Troubleshooting

  1. Try starting the server with no mods on a fresh install.

  2. If there are crash logs, they will be available in the Files at ShooterGame/Saved/Crashes/UECC-Windows-*/CrashContext.runtime-xml

Crash Identifiers

Crashes will either stop the server or display 0-5% CPU usage. The number is in reference to RAM/Memory usage.

  1. Server crashing around 500MB is probably either a config issue or a corrupted install.

  2. Server crashing around 750MB is probably commandline issue.

  3. Server crashing around 1GB is probably either a MOD conflict or corrupted SavedArks files.

Known Issues

  1. Proxmox VM(s): You'll need to change your Processor Type to Host (Default: kvm64)

  2. ARK's wiki heavily reference A:SE and not all features are available in A:SA.

Recommended server settings

Minimum RAM

This server requires about 11GB of RAM to run with no players on a default map.

See the following - https://ark.wiki.gg/wiki/Dedicated_server_setup#RAM

Server Ports

Port Default
Game 7777
RCON (optional) 37015

Changes

  1. Ark SA - Remove incorrect ports from startup command and readme (#17)

    · Daniel Barton · 14bdb82

  2. SteamCMD + Other fixes

    · yesBad · edbf925

  3. Add steamcmd based eggs

    · Daniel Barton · 60ef9fb

All changes on GitHub

Problem with this egg?

Open an issue on GitHub. Include your Panel and Wings versions.

Install script 70 lines bash in ghcr.io/ptero-eggs/installers:debian Show
#!/bin/bash
# steamcmd Base Installation Script
#
# Server Files: /mnt/server
# Image to install with is 'ghcr.io/ptero-eggs/installers:debian'

##
#
# Variables
# STEAM_USER, STEAM_PASS, STEAM_AUTH - Steam user setup. If a user has 2fa enabled it will most likely fail due to timeout. Leave blank for anon install.
# WINDOWS_INSTALL - if it's a windows server you want to install set to 1
# SRCDS_APPID - steam app id found here - https://developer.valvesoftware.com/wiki/Dedicated_Servers_List
# SRCDS_BETAID - beta branch of a steam app. Leave blank to install normal branch
# SRCDS_BETAPASS - password for a beta branch should one be required during private or closed testing phases.. Leave blank for no password.
# INSTALL_FLAGS - Any additional SteamCMD  flags to pass during install.. Keep in mind that steamcmd auto update process in the docker image might overwrite or ignore these when it performs update on server boot.
# AUTO_UPDATE - Adding this variable to the egg allows disabling or enabling automated updates on boot. Boolean value. 0 to disable and 1 to enable.
#
 ##

# Install packages. Default packages below are not required if using our existing install image thus speeding up the install process.
#apt -y update
#apt -y --no-install-recommends install curl lib32gcc-s1 ca-certificates

## just in case someone removed the defaults.
if [[ "${STEAM_USER}" == "" ]] || [[ "${STEAM_PASS}" == "" ]]; then
    echo -e "steam user is not set.\n"
    echo -e "Using anonymous user.\n"
    STEAM_USER=anonymous
    STEAM_PASS=""
    STEAM_AUTH=""
else
    echo -e "user set to ${STEAM_USER}"
fi

## download and install steamcmd
cd /tmp
mkdir -p /mnt/server/steamcmd
curl -sSL -o steamcmd.tar.gz https://steamcdn-a.akamaihd.net/client/installer/steamcmd_linux.tar.gz
tar -xzvf steamcmd.tar.gz -C /mnt/server/steamcmd
mkdir -p /mnt/server/steamapps # Fix steamcmd disk write error when this folder is missing
cd /mnt/server/steamcmd

# SteamCMD fails otherwise for some reason, even running as root.
# This is changed at the end of the install process anyways.
chown -R root:root /mnt
export HOME=/mnt/server

## install game using steamcmd
./steamcmd.sh +force_install_dir /mnt/server +login ${STEAM_USER} ${STEAM_PASS} ${STEAM_AUTH} $( [[ "${WINDOWS_INSTALL}" == "1" ]] && printf %s '+@sSteamCmdForcePlatformType windows' ) +app_update ${SRCDS_APPID} $( [[ -z ${SRCDS_BETAID} ]] || printf %s "-beta ${SRCDS_BETAID}" ) $( [[ -z ${SRCDS_BETAPASS} ]] || printf %s "-betapassword ${SRCDS_BETAPASS}" ) ${INSTALL_FLAGS} validate +quit ## other flags may be needed depending on install. looking at you cs 1.6

## set up 32 bit libraries
mkdir -p /mnt/server/.steam/sdk32
cp -v linux32/steamclient.so ../.steam/sdk32/steamclient.so

## set up 64 bit libraries
mkdir -p /mnt/server/.steam/sdk64
cp -v linux64/steamclient.so ../.steam/sdk64/steamclient.so

## add below your custom commands if needed
## cleanup movies?
rm -rf /mnt/server/ShooterGame/Content/Movies

## touch log file
mkdir -p /mnt/server/ShooterGame/Saved/Logs
echo "--fresh install--" >> /mnt/server/ShooterGame/Saved/Logs/ShooterGame.log

## install end
echo "-----------------------------------------"
echo "Installation completed..."
echo "-----------------------------------------"