XASECO Upgrade

Upgrading the dedicated server and XASECO can be done in either order, or each individually, when a new version arrives. To find your current versions, see the boxed area in XASECO's log shortly after it has started. Compare to the version lists for the TMF dedicated server and for XASECO and upgrade if not the latest. The last version of the TMN/TMS/TMO dedicated was, build 2006-05-30, which will never need to be upgraded, so that is not described here.


To learn about the differences between versions, read the relevant release notes. To see the differences between configuration files, especially new options that need to be added to your existing files, use 'diff' and 'dircmp' on Linux, or similar programs on Windows.

Dedicated server

Unpack the server distribution somewhere near your dedicated server tree, not overwriting that. Stop the running dedicated server, on Linux this can be done with an init.d script.

Copy the new dedicated executable (TrackmaniaServer for Linux, TrackmaniaServer.exe for Windows) to your server tree, overwriting the old one. Compare your existing GameData/Config/dedicated_cfg.txt file with the new one, and copy over any new entries. Compare the entire existing and new server trees for any new/changed files that might be relevant (this happens rarely).

Start the new dedicated (on Linux via init.d, see above) and check the start-up messages and the new Logs/ConsoleLog.##.txt file for problems.


Unzip the XASECO distribution somewhere near your XASECO tree, or, if you didn't make any custom changes to source code files, onto your existing tree, overwriting it. Stop the running XASECO, on Linux this can be done with an init.d script.

The new configuration files are in the newinstall/ directory, and won't overwrite your existing files during the unzip. Compare your existing configuration files with the new ones, and copy over any new entries. If you didn't unzip the distribution onto your existing tree, compare all source code files and copy any custom modifications to the new files, then move all new source code files into your existing tree.

Start the new XASECO (on Linux via init.d, see above) and check the new aseco.log file (or logfile.txt) for problems.
Last updated: 2023-07-06