ludix0/asa repository overview

⁠ARK: Survival Ascended — Dedicated Server (Docker)

🇬🇧 English⁠ | 🇫🇷 Français⁠

⁠English

Docker container to host an ARK: Survival Ascended dedicated server (SteamCMD App ID 2430930).

ARK: Survival Ascended has no native Linux server binary — the real server is a Windows executable (ArkAscendedServer.exe). This image runs it under Proton-GE (GE-Proton11-5, pinned in the Dockerfile) on top of a headless Xvfb display and a software Vulkan driver (mesa-vulkan-drivers / lavapipe), since the Unreal Engine 5 server still tries to initialize a graphics device even with no GPU present. Everything else (SteamCMD download/update, launch parameters, process supervision) is a custom start_server.sh, not a third-party image.

• Docker Hub image: ludix0/asa⁠
• Ports used: 7777/udp (game), 27020/tcp (RCON)

⁠Requirements

• Docker Engine + Docker Compose v2
• ~40 GB free disk space for the server files (more with mods)
• No GPU required (software Vulkan rendering)
• A free UDP port for the game and a free TCP port for RCON

⁠Method 1 — Quick install from Docker Hub (recommended)

Create a folder, add a docker-compose.yml:

services:
  asa:
    image: ludix0/asa:latest
    container_name: ASA
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
      - ASA_SERVER_PASSWORD=
      - ASA_ADMIN_PASSWORD=changeme
      - GAME_PORT=7777
      - RCONPort=27020
      - MAX_PLAYERS=20
      - UPDATE_ON_START=true
      - map=Astraeos_WP
      - SessionName=Ludix_ASA_FR
      - CLUSTER_ID=LudixASACluster
      - NoBattlEye=True
      - ServerPVE=True
    ports:
      - 0.0.0.0:7777:7777/udp
      - 0.0.0.0:27020:27020/tcp
    volumes:
      - ./filesServer:/home/steam/asa_server
      - ./logs:/home/steam/asa_server/ShooterGame/Saved/Logs
      - ./cluster-shared:/home/steam/asa_server/ShooterGame/Binaries/Win64/cluster-shared
      - ./proton-steam:/home/steam/Steam
      - ./proton-prefix:/home/steam/proton-prefix
      - ./steamcmd:/home/steam/steamcmd

Then:

docker compose up -d
docker compose logs -f

⁠Method 2 — Build from source (GitHub)

git clone <YOUR-GITHUB-REPO-URL>
cd asa
cp .env.example .env   # fill in your own values
docker compose build
docker compose up -d

⁠Environment variables

Connection / core

Server / session

Gameplay (multipliers, limits, misc.) — all optional, defaults shown are this project's current settings in docker-compose.yml:

Seasonal events — on ARK: Survival Ascended, seasonal events are real CurseForge mods published by StudioWildcardMods, not a simple flag. Each is added to MODS automatically while today's date falls within its window. <NAME>_DATE accepts a MM/DD-MM/DD range and can wrap around New Year (e.g. Winter Wonderland); set <NAME>=False to disable one event entirely.

Each event also has an independent <NAME>_COLORS toggle (default True), separate from the mod toggle above. When True and today falls within <NAME>_DATE, it adds -ActiveEvent=<...> to the launch options, which forces the seasonal color palette onto wild dinos — with or without the CurseForge mod also enabled. Only one can be active at a time.

Already-spawned wild dinos keep their old colors until they die — a full refresh happens only gradually as players hunt. Each event has one more independent toggle, <NAME>_DESTROY_WILD_DINOS (default False, since it kills every wild dino on the map, not just recolors them): when True and the event is active, start_server.sh waits for RCON to come up after the container starts, then sends DestroyWildDinos automatically via a small built-in Source RCON client (no extra package — reuses the python3 already installed for the Proton launcher). Runs once per container start, in the background, without blocking the game.

Game.ini settings — separate from GameUserSettings.ini above, Game.ini ([/script/shootergame.shootergamemode]) isn't readable from launch parameters at all; start_server.sh writes it at container start. All default to ARK's stock values — no change until edited.

⁠Volumes

⁠Ports

⁠Français

Conteneur Docker pour héberger un serveur dédié ARK: Survival Ascended (SteamCMD App ID 2430930).

ARK: Survival Ascended n'a pas de binaire serveur Linux natif — le vrai serveur est un exécutable Windows (ArkAscendedServer.exe). Cette image l'exécute via Proton-GE (GE-Proton11-5, figé dans le Dockerfile) au-dessus d'un écran virtuel Xvfb et d'un pilote Vulkan logiciel (mesa-vulkan-drivers / lavapipe), car le serveur sous Unreal Engine 5 tente d'initialiser un périphérique graphique même sans GPU. Tout le reste (téléchargement/mise à jour SteamCMD, paramètres de lancement, supervision du processus) vient d'un start_server.sh maison, pas d'une image tierce toute faite.

• Image Docker Hub : ludix0/asa⁠
• Ports utilisés : 7777/udp (jeu), 27020/tcp (RCON)

⁠Prérequis

• Docker Engine + Docker Compose v2
• ~40 Go d'espace disque libre pour les fichiers serveur (plus avec des mods)
• Aucun GPU requis (rendu Vulkan logiciel)
• Un port UDP libre pour le jeu et un port TCP libre pour le RCON

⁠Méthode 1 — Installation rapide depuis Docker Hub (recommandé)

Créer un dossier, y ajouter un docker-compose.yml :

services:
  asa:
    image: ludix0/asa:latest
    container_name: ASA
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - PUID=1000
      - PGID=1000
      - ASA_SERVER_PASSWORD=
      - ASA_ADMIN_PASSWORD=changeme
      - GAME_PORT=7777
      - RCONPort=27020
      - MAX_PLAYERS=20
      - UPDATE_ON_START=true
      - map=Astraeos_WP
      - SessionName=Ludix_ASA_FR
      - CLUSTER_ID=LudixASACluster
      - NoBattlEye=True
      - ServerPVE=True
    ports:
      - 0.0.0.0:7777:7777/udp
      - 0.0.0.0:27020:27020/tcp
    volumes:
      - ./filesServer:/home/steam/asa_server
      - ./logs:/home/steam/asa_server/ShooterGame/Saved/Logs
      - ./cluster-shared:/home/steam/asa_server/ShooterGame/Binaries/Win64/cluster-shared
      - ./proton-steam:/home/steam/Steam
      - ./proton-prefix:/home/steam/proton-prefix
      - ./steamcmd:/home/steam/steamcmd

Puis :

docker compose up -d
docker compose logs -f

⁠Méthode 2 — Build depuis les sources (GitHub)

git clone <URL-DE-VOTRE-DEPOT-GITHUB>
cd asa
cp .env.example .env   # renseigner vos propres valeurs
docker compose build
docker compose up -d

⁠Variables d'environnement

Connexion / cœur

Serveur / session

Gameplay (multiplicateurs, limites, divers) — tous facultatifs, valeurs par défaut = réglages actuels de ce projet dans docker-compose.yml :

Événements saisonniers — sur ARK: Survival Ascended, les événements saisonniers sont de vrais mods CurseForge publiés par StudioWildcardMods, pas un simple réglage. Chacun est ajouté automatiquement à MODS tant que la date du jour tombe dans sa période. <NOM>_DATE accepte une plage MM/JJ-MM/JJ, qui peut traverser le 1er janvier (ex. Winter Wonderland) ; mettre <NOM>=False pour désactiver un événement.

Chaque événement dispose aussi d'un interrupteur <NOM>_COLORS indépendant (défaut True), séparé de l'interrupteur du mod ci-dessus. Quand il vaut True et que la date du jour tombe dans <NOM>_DATE, il ajoute -ActiveEvent=<...> aux options de lancement, ce qui force la palette de couleurs saisonnière sur les dinos sauvages — avec ou sans le mod CurseForge activé en plus. Un seul actif à la fois.

Les dinos sauvages déjà présents gardent leur ancienne couleur tant qu'ils ne meurent pas — le renouvellement complet ne se fait que progressivement, au rythme de la chasse des joueurs. Chaque événement dispose d'un interrupteur supplémentaire indépendant, <NOM>_DESTROY_WILD_DINOS (défaut False, car ça tue tous les dinos sauvages de la carte, pas seulement leur couleur) : quand il vaut True et que l'événement est actif, start_server.sh attend que le RCON réponde après le démarrage du conteneur, puis envoie automatiquement DestroyWildDinos via un petit client RCON (protocole Source RCON) écrit en Python et intégré au script — pas de paquet supplémentaire, python3 est déjà présent pour le lanceur Proton. Se déclenche une fois par démarrage du conteneur, en arrière-plan, sans bloquer le lancement du jeu.

Réglages Game.ini — distinct de GameUserSettings.ini ci-dessus, Game.ini ([/script/shootergame.shootergamemode]) n'est pas du tout lisible depuis les paramètres de lancement ; start_server.sh l'écrit au démarrage du conteneur. Tous à la valeur par défaut d'ARK — aucun changement tant qu'ils ne sont pas modifiés.

⁠Volumes

⁠Ports