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.

Note

This installation documentation is fully synchronized with the version 1.1.8 application update and follows the newest deployment structure.

Installation Methods

Desktop App (Installer Script)

The standalone Desktop application can be installed effortlessly using our automated script. It will detect your environment and natively integrate the .AppImage via AppImageLauncher.

Requirements

This method requires AppImageLauncher to integrate the app into your system menu.

• For Arch Linux, the script will attempt to install it automatically.
• For other systems, please install it manually by following the official AppImageLauncher Documentation.

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 Desktop Installer

./ttl.sh -Id

This will automatically download and install the latest synchronized release package for your operating system.

Desktop App (Native)

Install the pre-compiled binary package natively via your distribution’s package manager.

Arch Linux

There are two installation methods for Arch Linux and its derivatives (Manjaro, EndeavourOS, CachyOS):

1. Via AUR (Automated) Use an AUR helper like paru or yay:

paru -S truckers-tool-linux-bin

2. Manual (Download & Install) Download the installation package and install using pacman (use * for the latest version):

curl -LO "https://github.com/efzynx/truckers-tool-linux/releases/latest/download/truckers-tool-linux_*_amd64.pacman"
sudo pacman -U truckers-tool-linux_*_amd64.pacman

Debian / Ubuntu

There are two installation methods:

1. Via APT Repository (Automated) (Coming soon…)

2. Manual (Download & Install) Download the installation package and install using dpkg (use * for the latest version):

curl -LO "https://github.com/efzynx/truckers-tool-linux/releases/latest/download/truckers-tool-linux_*_amd64.deb"
sudo dpkg -i truckers-tool-linux_*_amd64.deb

Fedora / RHEL (RPM)

There are two installation methods:

1. Via DNF Repository (Automated) (Coming soon…)

2. Manual (Download & Install) Download the installation package and install using dnf (use * for the latest version):

curl -LO "https://github.com/efzynx/truckers-tool-linux/releases/latest/download/truckers-tool-linux-*.x86_64.rpm"
sudo dnf install truckers-tool-linux-*.x86_64.rpm

Web App (Local Server)

If you prefer to run the application in your browser via a local server background process.

Prerequisites

The Web App requires Node.js and PM2.

• Node.js: You can easily install it by running ./ttl.sh node.
• PM2: The installer script will attempt to install it automatically. Alternatively, you can install it manually by running npm install -g pm2.

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 Background Setup This will clone the repository, install dependencies, and start the app:

./ttl.sh -IS

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

Manual (Source)

If you want to contribute or run from the source code:

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

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.

Uninstallation

Desktop App

Desktop App (Installer Script / AppImage) If you installed the application using the installer script (ttl.sh -Id), it leverages a standalone .AppImage integrated into your system. To uninstall:

1. Search for “Truckers Tool Linux” in your system’s application launcher/menu.
2. Right-click the icon and select Remove from system.
3. Alternatively, you can directly delete the Truckers Tool Linux*.AppImage file, usually located in your ~/Applications folder.

Desktop App (Native / Binary Package) Remove the installed package by running the appropriate uninstaller command in your terminal:

Arch Linux

# If installed via AUR
paru -Rns truckers-tool-linux-bin

# If installed via pacman
sudo pacman -Rns truckers-tool-linux

Debian / Ubuntu

sudo dpkg -r truckers-tool-linux
# Or: sudo apt remove truckers-tool-linux

Fedora / RHEL (RPM)

sudo dnf remove truckers-tool-linux

Web App (Local Server)

If you run the application as a Web App via the PM2 local server background process:

1. Stop the application and remove it from PM2

pm2 delete truckers-tool-linux
pm2 save --force

2. Remove the cloned installation directory

rm -rf ~/.truckers-tool-linux