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: trueRestart the dedicated server after editing the generated configuration.
Server name, description and password
| Parameter | Function | Documented limit |
|---|---|---|
lobby_name | Session name | 63 characters |
description | Short description | 63 characters |
welcome_message | Welcome message | 127 characters |
password | Optional password | 63 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_portandquery_virtual_port, defaulting to 100 and 101, range 100–200.connection_dedicated_portandquery_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
| Setting | Purpose |
|---|---|
traffic | Enable AI traffic |
player_damage | Control vehicle damage from other players |
force_speed_limiter | Require a speed limiter |
name_tags | Display player labels |
service_no_collision | Modify collisions in service areas |
in_menu_ghosting | Control 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.