Installation Guide

There are several ways to run Truckers Tool Linux on your system. The most recommended method for Linux users is using the Installer Script.

System Requirements

• Operating System: Modern Linux distributions (Ubuntu, Arch, Fedora, etc).
• Git: Installed on your system.
• Node.js: Version 18 or newer (the installer script can safely install it via nvm).
• Game: Euro Truck Simulator 2 or American Truck Simulator installed (Native, Wine, or Proton).
  • Note: This application has been thoroughly tested on ETS2 version 1.37 & 1.49 and ATS version 1.36. For other versions, feel free to try it and give your feedback on our GitHub Issues page if you experience any problems.

Installation Methods

Installer Script (Recommended)

This is the fastest way to automatically install and run TTL.

1. Download Installer Script

curl -fsSL https://raw.githubusercontent.com/efzynx/truckers-tool-linux/main/ttl.sh -o ttl.sh
chmod +x ttl.sh

2. Run Automatic Setup This command will clone the repository, install dependencies, and run the app at once:

./ttl.sh -IS

Open your browser at http://localhost:3214 🎉

Manual (from Source)

If you want to contribute or try the latest features from the development branch:

1. Clone Repository:

git clone https://github.com/efzynx/truckers-tool-linux.git
cd truckers-tool-linux

2. Install Dependencies:

npm install

3. Run Application:

npm run dev

AppImage

For portable use without installation:

1. Download the latest .AppImage file from the Releases page.
2. Give execution permission: chmod +x Truckers_Tool_Linux.AppImage.
3. Run the application.

Post-Installation Steps

Initial Setup

After the application opens, the first thing you should do is set the game profile path in the Settings page so TTL can detect your save games automatically.