This guide covers the atsserver module in AlphaGSM.
atsserver is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux
baseline. GitHub integration skips this lifecycle until an owned client export
is staged; it does not start the process or Docker runtime without those files.
Local runs remain process-backed by default unless you opt into the Docker
backend.
Requirements
- SteamCMD runtime libraries (
lib32gcc-s1, lib32stdc++6)
- Exported ATS server packages/settings from an owned American Truck Simulator client install; the anonymous dedicated-server payload alone is not enough to finish startup
- Python packages from
requirements.txt
Quick Start
Create the server:
alphagsm myatsserve create atsserver
Run setup:
alphagsm myatsserve setup
Start it:
alphagsm myatsserve start
Check it:
alphagsm myatsserve status
Stop it:
alphagsm myatsserve stop
Setup Details
Setup configures:
- the game port (default 27015)
- the query port (default 27016)
- the install directory
- SteamCMD downloads the server files
This server is supported in ENABLED (BYO) mode. The dedicated server still
expects the exported server-packages/settings payload generated by the full
game client. If startup logs report Server packages file not found, run
export_server_packages from an owned ATS client and stage the resulting
files before retrying AlphaGSM startup.
Useful Commands
alphagsm myatsserve update
alphagsm myatsserve backup
Notes
- Module name:
atsserver
- Default game port: 27015
- Default query port: 27016
query and info use Steam A2S on the dedicated query port, not the game port.
Server variables
After create atsserver, inspect or change these with set:
alphagsm myserver set --list
alphagsm myserver set KEY --describe
alphagsm myserver set KEY VALUE
This module does not declare schema-backed keys. set --list after
create is still the live source of truth.
Developer Notes
Run File
- Executable:
bin/linux_x64/americantruck_server
- Location:
<install_dir>/bin/linux_x64/americantruck_server
- Engine: Custom (SteamCMD)
- SteamCMD App ID:
2239530
Official SCS dedicated-server documentation says the dedicated app can be
downloaded anonymously, but first launch still requires server_packages.sii
and server_packages.dat exported from a real client profile via
export_server_packages. Stage those files into
<install_dir>/.local/share/American Truck Simulator/ before start.
Server Configuration
Maps and Mods
- Map directory: Check game documentation
- Mod directory: Check game documentation
- Workshop support: No
BYO file helper
Inspect this game's required files, source instructions and destinations with
alphagsm <server-name> assets requirements; check the declared files with
alphagsm <server-name> assets check. File checks do not establish game readiness.
Generate server_packages.sii and server_packages.dat in the owned client
using export_server_packages. For a relative configdir, the allowlisted
import places both exports under that directory in the server installation.
For an absolute configdir, stage both files manually in that home;
assets requirements and assets check support it, while managed import and
export explain the manual-staging requirement.
See BYO files and private SteamCMD acquisition.