Alpha Game Server Manager

Dedicated server guide

Euro Truck Simulator 2

Manage ets2server with AlphaGSM. Choose a runtime supported by the recorded module capabilities.

Operator-provided prerequisites required · Support evidence: 2026-10-16.

Build setup commands
Runtime familysteamcmd-linux

Declared runtimes: Docker or a Linux host process.

Network bindings

queryport/UDP, queryport/TCP, 27015/UDP, 27015/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Mods and plugins

No mod support is declared in this snapshot; review the game guide before adding mods.

Backup hook

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Choose a supported runtime

Linux and Docker quickstart

Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Docker

Complete interactive setup and review game-specific configuration before starting the server. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

  1. Start the Docker manager ./alphagsm-docker start
  2. Create the game instance ./alphagsm-docker my-ets2server create ets2server
  3. Complete interactive setup ./alphagsm-docker my-ets2server setup
  4. Start the game server ./alphagsm-docker my-ets2server start
  5. Check the instance status ./alphagsm-docker my-ets2server status
./alphagsm-docker start
./alphagsm-docker my-ets2server create ets2server
./alphagsm-docker my-ets2server setup
./alphagsm-docker my-ets2server start
./alphagsm-docker my-ets2server status

Host process

Complete interactive setup and review game-specific configuration before starting the server. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

  1. Create the game instance ./alphagsm my-ets2server create ets2server
  2. Complete interactive setup ./alphagsm my-ets2server setup
  3. Check the host prerequisites ./alphagsm my-ets2server doctor
  4. Start the game server ./alphagsm my-ets2server start
  5. Check the instance status ./alphagsm my-ets2server status
./alphagsm my-ets2server create ets2server
./alphagsm my-ets2server setup
./alphagsm my-ets2server doctor
./alphagsm my-ets2server start
./alphagsm my-ets2server status

This guide covers the ets2server module in AlphaGSM.

ets2server is currently ENABLED (BYO) on the documented Ubuntu 24.04 Linux baseline. GitHub integration skips this lifecycle unless ALPHAGSM_ETS2_SERVER_PACKAGES_DIR supplies nonempty owned client exports. Local runs remain process-backed by default unless you opt into the Docker backend.

Requirements

  • screen
  • SteamCMD runtime libraries (lib32gcc-s1, lib32stdc++6)
  • Exported ETS2 server packages/settings from an owned Euro Truck Simulator 2 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 myets2serv create ets2server

Run setup:

alphagsm myets2serv setup

Start it:

alphagsm myets2serv start

Check it:

alphagsm myets2serv status

Stop it:

alphagsm myets2serv 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 ETS2 client and stage the resulting files before retrying AlphaGSM startup.

Place both server_packages.sii and server_packages.dat in <install_dir>/.local/share/Euro Truck Simulator 2/ before starting. AlphaGSM uses this directory as the dedicated server's home; set configdir selects another directory. Setup and set synchronize the native connection and query ports while preserving other server settings.

CI and smoke runners accept ALPHAGSM_ETS2_SERVER_PACKAGES_DIR pointing to a directory containing both exported files. Missing exports are a BYO prerequisite skip; a supplied directory with missing or empty files fails validation.

Useful Commands

alphagsm myets2serv update
alphagsm myets2serv backup

Notes

  • Module name: ets2server
  • Default game port: 27015
  • Default query port: 27016

Server variables

After create ets2server, 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/eurotrucks2_server
  • Location: <install_dir>/bin/linux_x64/eurotrucks2_server
  • Engine: Custom (SteamCMD)
  • SteamCMD App ID: 1948160

Smoke and integration validation track readiness through alphagsm info --json returning protocol a2s instead of waiting for screen-log markers.

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.

Configuration templates

Reference files from this source revision. Review paths, passwords and game-specific settings before use.

Share your server

Sector Alpha server directory

When your server is ready, you can publish its connection details and community information on Sector Alpha. Review your listing and keep the information current.

Find a community

Browse the directory for game servers and their published connection details.

Browse server directory

Publish your server

Prepare a name, address and description for your listing.

Publish a server

Manual server sharing instructions

Frequently asked questions

What support evidence is recorded for Euro Truck Simulator 2?

Operator-provided prerequisites required. Operator-provided game files, runtime or other prerequisites are required; follow the game guide before setup.

Which runtimes can run Euro Truck Simulator 2?

Declared runtimes: Docker or a Linux host process.

Which ports does Euro Truck Simulator 2 use?

queryport/UDP, queryport/TCP, 27015/UDP, 27015/TCP. Named port values remain unknown; review the game guide and configuration for additional requirements.

Can I add mods to Euro Truck Simulator 2?

No mod support is declared in this snapshot; review the game guide before adding mods.

How should I back up Euro Truck Simulator 2?

A module-specific backup hook is declared. Review the game guide for its scope, restore procedure and shutdown requirements.

Source and support evidence

This guide mirrors AlphaGSM’s upstream documentation at 32cef5ba9e03053c8e461fffa0ba133b160b528d. Commands and prerequisites can change. Check current support notes before installation.

All game guides