ARK: Survival Ascended Fresh Server Won't Boot First Time?
You just installed a fresh ARK: Survival Ascended server, hit Start, and the log shows two lines and then stops:
Starting ARKSA server...
Writing umu config to arksa/bin/umu-config.toml
Five minutes later it still shows the same two lines. The panel says "starting". You click Stop, click Start, and the cycle repeats. Most customers conclude the server is broken.
It almost never is. ARK Survival Ascended's first boot has to do several one-time tasks that look like nothing is happening. This page is the diagnostic for the false alarm and the real failure.
What first boot is actually doing
- One-time runtime setup (~30s on first boot only): the server prepares its per-deployment workspace and config files. Subsequent restarts skip this step.
- CurseForge mod download (anywhere from 30 seconds to 10 minutes): if your
GameUserSettings.inilists anyActiveMods, ARK pulls every one of them from CurseForge before the world even loads. Mods are 100–800 MB each. - Shader / pipeline cache (Unreal Engine 5, several minutes the first time): UE5 compiles shader pipelines for the server's GPU profile (yes, even on a headless server).
- World load and save bootstrap: the world file is generated (for a new save) or deserialised (for an existing save).
- Steam handshake and EOS init: required for the server to appear in the in-game browser.
None of these write a heartbeat to the visible log every few seconds. To an observer the server looks idle.
The log signal that says "really booting"
While the panel is silent, the work is happening in different files. To check, you can read:
arksa/process-control/stdout.log # main game stdout
arksa/process-control/stderr.log # trace noise + real errors
arksa/data/ShooterGame/Saved/Logs/ # ARK's own log directory
If stdout is past the early-boot lines and you can see ARK log entries flowing, the server is alive and progressing. If stdout is frozen but the deployment's CPU usage is non-zero (visible in the panel's resource graph), the server is still working: it is most likely downloading mods or compiling shaders.
The first useful "ARK is initialised" sign is a log line that mentions Log file open followed by LogShooterGame entries.
Common false alarms
1. CurseForge mods are downloading
The biggest single cause of "fresh install does not boot". ARK fetches mods serially from CurseForge before world load. Five mods at 300 MB each on a 100 Mbps link is 2 minutes minimum, often longer because CurseForge throttles. The server cannot proceed past mod download. Restarting the cycle just restarts the download from scratch.
What to do: leave it for 10 minutes uninterrupted on a fresh install with mods. Watch the deployment's outbound and disk-write graphs in the panel; if either is non-zero, downloads are progressing.
2. One-time runtime workspace setup
The first time the server starts on a fresh deployment, the runtime writes its workspace files to the deployment's home directory. This is a one-time cost of ~30 seconds. Subsequent restarts skip it.
3. Shader pipeline compile (UE5)
UE5 compiles a pipeline cache on the first run for a given GPU vendor + driver combo. On a fresh server this can take several minutes. The cache lives under arksa/data/ShooterGame/Saved/ and persists across restarts; the second boot is much faster.
When it really is broken
The boot is genuinely failing if any of these are true:
stderr.logcontains a non-trace fatal error (not the usual019c:trace:steamclient:...noise).- The deployment's CPU and disk usage are both zero for more than 5 minutes after the early-boot lines.
- The supervisor logs a process exit in
run_watch.stderr.log. - The runtime workspace is missing or the install is corrupted (reinstall the deployment).
In any of those cases, the boot has actually stopped and a restart is justified. Otherwise, every restart just wipes the mod download and starts over.
Required launch flags (set automatically on Supercraft)
The Supercraft ASA plugin launches the server with these flags. If you are following a self-hosted guide elsewhere and the server crash-loops, double-check these are set:
| Flag | Why it matters |
|---|---|
-port=<game-port> |
The game port players type to join. |
-QueryPort=<game-port + 1> |
Steam favorites use the query port, not the game port. Without this, the server is invisible to Steam favorites. |
-NoBattlEye |
BattlEye is not supported on headless dedicated servers; without this flag, the server fails to initialise its anti-cheat hook. |
-newsaveformat |
Required for Survival Ascended save compatibility. Old "ARK Survival Evolved" save format will not load. |
-servergamelog |
Writes the in-game log to the ARK log directory, useful for admin debugging. |
-PublicIPForEpic=<node_ip> |
Required for Epic Online Services so non-Steam clients can connect. |
Mods not loading after the boot finally completes
If the server eventually comes online but a mod is not active in-game, the symptom is different: the mod downloaded but did not register. Two requirements:
- The mod's CurseForge ID must appear in
ActiveMods=inGameUserSettings.ini. - The downloaded mod assets must be present under
ShooterGame/Content/Mods/<ModID>/.
If both are true and the mod still does not appear in-game, the mod author may have shipped a version that targets a newer ARK build than your server. See ASA mods not loading for the deeper diagnosis.
Dev commands won't work after boot
Console commands (admin / cheat commands) require an admin login first. In the in-game console:
enablecheats <your_admin_password>
Once that has succeeded, cheat-prefixed commands work for the rest of the session on that client. Without enablecheats, the client sees the command but the server refuses to execute it. The companion wiki page ARK admin commands lists every command worth knowing.
Quick rule: on a fresh ASA install with mods, leave the server alone for at least 10 minutes after pressing Start. Watch the deployment's CPU and outbound graphs in the panel: non-zero means progress, zero across both for >5 minutes means actually stuck.
ASA hosting that doesn't restart on the mod download
On Supercraft ARK: Survival Ascended hosting, the launch flags above are pre-configured, the runtime workspace persists across restarts, and the panel exposes the mod download progress so you do not have to guess whether the server is stuck. Pair with ASA dedicated server setup for the full first-boot walkthrough.