ETS2 server_config.sii Configuration Reference

Configure an ETS2 dedicated server: server_config.sii defaults, eight player slots, ports 27015/27016, Steam Game Server Login Tokens, moderators and optional mods.

TruckersMP version gameplay artwork
Source: coop-legends.de

Overview

The server_config.sii file defines settings for an ETS2 dedicated server, including server name, description, password, player count, network ports, optional mods and moderators.

Version status: SCS released ETS2 1.61 on September 17, 2026. These technical procedures were last tested with 1.60 on September 3, not fully retested on 1.61. The SCS dedicated-server wiki was last edited in 2023, so its defaults are official documentation rather than separately measured 1.61 values.

Where is server_config.sii stored?

At its first launch, the dedicated server creates a default server_config.sii in its ETS2 game-user directory. That is normally the standard ETS2 user path. Windows permits an alternative home directory using -homedir; SCS says the game and server should use redirected paths consistently.

Example settings and documented defaults

Important: The following is a partial extract, not a complete runnable SII configuration file. Launch the server once to generate the actual file and edit the relevant entries there.

lobby_name: "My ETS2 Server" description: "Private Convoy" welcome_message: "Welcome!" password: "" max_players: 8 connection_virtual_port: 100 query_virtual_port: 101 connection_dedicated_port: 27015 query_dedicated_port: 27016 server_logon_token: "" traffic: true force_speed_limiter: false name_tags: true

Restart the dedicated server after editing the generated configuration.

Server name, description and password

ParameterFunctionDocumented limit
lobby_nameSession name63 characters
descriptionShort description63 characters
welcome_messageWelcome message127 characters
passwordOptional password63 characters

For private friends-only use, configure a password and a recognizable lobby name.

Player limit and vehicle population

max_players sets the maximum number of drivers. SCS documents eight players as the supported cap. Additional parameters include max_vehicles_total, max_ai_vehicles_player and max_ai_vehicles_player_spawn. SCS documents respective defaults of 100, 50 and 50. These affect simulated vehicles and potentially server/client performance; only adjust them when you can test the consequences.

Virtual and physical ports

SCS distinguishes:

  • connection_virtual_port and query_virtual_port, defaulting to 100 and 101, range 100–200.
  • connection_dedicated_port and query_dedicated_port, defaulting to 27015 and 27016.

The virtual ports do not need router forwarding; physical ports are relevant for external access. Parallel dedicated instances must use separate physical ports and different server logon tokens.

Steam Game Server Login Token

Without server_logon_token, the dedicated server uses an anonymous identity with a nonpersistent server ID. To establish a persistent Steam server identity, obtain a token from Steam's Game Server Account Management.

Use the game App ID 227300 when generating the token. SCS specifically says not to use the dedicated server's separate App ID 1948160 for token generation. Keep tokens private.

Traffic, damage and speed restrictions

SettingPurpose
trafficEnable AI traffic
player_damageControl vehicle damage from other players
force_speed_limiterRequire a speed limiter
name_tagsDisplay player labels
service_no_collisionModify collisions in service areas
in_menu_ghostingControl collision behavior while menus are open

Optional mods

mods_optioning determines whether mods marked as optional are actually treated as optional. The underlying feature arrived in ETS2 1.45; an optional mod must have mp_mod_optional configured appropriately. The real map, DLC and mod selection is recorded in server_packages.sii and server_packages.dat, not primarily in server_config.sii.

Assign moderators by Steam ID

Because the dedicated server has no graphical moderation assignment interface, set moderator_list with the relevant Steam account IDs. Those players will be recognized as moderators when joining. SCS documents chat commands such as /set_time <HH:MM>, /set_rain_factor <0 to 1> and /help.

Settings that do not apply to dedicated servers

SCS explicitly marks friends_only and show_server as unused in the documented dedicated-server config. Do not count on either option to hide the server or limit access. Use an actual session password and configure networking/NAT correctly.

Running multiple instances

For alternative files, SCS describes -server and -server_cfg. Windows -homedir can select an alternative game-user directory; on Linux the documented mechanism is XDG_DATA_HOME.

The wiki also mentions -nosingle but says that behavior was due to become default in “the next patch”; as the wiki was last edited in 2023, this does not establish whether that switch is still necessary in 1.61. What remains clear is that simultaneous servers need unique physical port pairs and distinct login tokens.

ETS2 server_config.sii FAQ

SCS documents a supported maximum of eight players.

100 and 101 for virtual ports; 27015 and 27016 for physical dedicated ports.

Use game App ID 227300, not the dedicated-server App ID 1948160.

Yes. Set the password field in the generated server_config.sii.

In exported server_packages.sii and server_packages.dat. server_config.sii mainly describes the server session.