Skip to content

Atsserver

Jump to bottom
github-actions[bot] edited this page Oct 17, 2026 · 3 revisions

American Truck Simulator

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.

Clone this wiki locally