Panel — public source drop (v0.9.0)

Self-hostable game-server control panel: controller + agent + 26 game
modules. One-line install (prebuilt release, no Go required):

  curl -fsSL https://git.pdxtechs.com/dbledeez/panel/raw/branch/main/install.sh | sudo bash

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-07-14 21:17:39 -07:00
commit a00bd620a1
2160 changed files with 300574 additions and 0 deletions
+62
View File
@@ -0,0 +1,62 @@
# ARK: Survival Ascended — panel module
A panel-compatible module for running ARK: Survival Ascended (SA) dedicated
servers on any agent with Docker available.
## What this is
A thin manifest wrapper around `mschnitzer/ark-survival-ascended-server`
the most actively-maintained community image for ASA on Linux. That image
handles the Proton runtime (ASA has no native Linux server) + SteamCMD +
the Windows binary wrapper.
## First-run flow
1. **Create** the server in the panel (pick `ARK: Survival Ascended` from
the module picker).
2. Click **Update** on its card → our generic SteamCMD sidecar downloads
~18 GB into the instance's `install` volume.
3. Open **Config** → under *Identity*, set the server name and admin
password. Save.
4. Click **Start**. First map load takes 35 minutes — watch the **Console**
tab; when you see `Server started on port 7777`, it's ready.
## RAM
ASA is a hog. Plan for:
- **12 GB** minimum for `TheIsland_WP` with up to ~30 players
- **16 GB** comfortable
- **24 GB** if you're running a popular community
## Changing maps
Set `SERVER_MAP` in the container env (the mschnitzer image reads it at
boot). Valid values include:
- `TheIsland_WP`
- `TheCenter_WP`
- `ScorchedEarth_WP`
- `Aberration_WP`
- `Extinction_WP`
- `Astraeos_WP`
- `ClubArk_WP`
After changing the map, click **Stop → Start**.
## Using your own image
Replace the `image:` field in `module.yaml` with your Docker image. Keep
the volume mounts (`/home/steam/ASA/AppFiles` and
`/home/steam/ASA/AppFiles/ShooterGame/Saved`) so SteamCMD's output lands
where ASA expects and saves persist across updates.
## Known quirks
- **First start is slow** (35 min). This is Proton loading + ARK doing
its world init. Subsequent starts are ~90 seconds.
- **Windows file locks** — don't run Update while the server is running;
SteamCMD will conflict with ARK's open file handles.
- **EAC is enabled by default.** If you want to run mods that EAC blocks,
disable via `-NoBattlEye` in the server args (community image exposes
an env for this).