Skip to content

Linux Installation

Jump to bottom
oxGorou edited this page May 29, 2026 · 10 revisions

Linux Installation

Having problems? See Linux Troubleshooting.

Quick Install

Run as your normal user not root:

curl -fsSL https://raw.githubusercontent.com/HorizonUnix/UXTU4Linux/main/install.sh | bash

The installer asks for your sudo password once to install system packages and write to /opt and /usr/local/bin. After that, everything runs as your regular user. The app launches automatically when the installer finishes.

On future sessions:

uxtu4linux

What the Installer Does

Step Detail
Detect package manager apt, dnf, yum, pacman, zypper
Install system deps dmidecode, python3, python3-venv, curl, unzip
Download release Latest zip from GitHub releases
Extract to /opt/uxtu4linux/src/ All app files
Create venv at /opt/uxtu4linux/venv/ Isolated Python environment
Install Python deps pyzmq
Install /usr/local/bin/uxtu4linux System-wide launcher
Launch app Opens the first-run wizard immediately

File layout after install:

/opt/uxtu4linux/
├── src/
│   ├── UXTU4Linux.py
│   └── Assets/
│       ├── config.ini              <- created on first run
│       ├── custom.json     <- created on first run
│       ├── Linux/
│       │   └── ryzenadj
│       ├── Modules/
└── venv/
/usr/local/bin/uxtu4linux

First-Run Wizard

On the first launch, the wizard walks through three steps:

  1. Welcome: overview of the app.
  2. Daemon service: installs and enables uxtu4linux.service so the power daemon starts automatically on boot.
  3. Hardware detection: reads your CPU info via dmidecode and writes it to config.ini.

After the wizard completes, go to Power Management -> Select Preset to choose your starting preset.

Manual Installation

1. Install system dependencies

# Debian / Ubuntu
sudo apt install python3 python3-venv python3-pip dmidecode

# Fedora / RHEL
sudo dnf install python3 python3-pip dmidecode

# Arch
sudo pacman -S python python-pip dmidecode

# openSUSE
sudo zypper install python3 python3-pip dmidecode

2. Download and extract

curl -fsSL -o UXTU4Linux.zip \
  https://github.com/HorizonUnix/UXTU4Linux/releases/latest/download/UXTU4Linux.zip
unzip UXTU4Linux.zip && cd UXTU4Linux

3. Install Python dependencies

pip3 install pyzmq

4. Make binaries executable

chmod +x UXTU4Linux.py Assets/Linux/ryzenadj

5. Run

python3 UXTU4Linux.py

Updating

UXTU4Linux checks for updates on every launch (when softwareupdate = 1 in config.ini). When an update is available you will see the changelog and can confirm with y.

The update process:

  1. Downloads the new release zip
  2. Backs up config.ini and custom.json
  3. Replaces /opt/uxtu4linux/src/
  4. Restores your config and custom presets
  5. Restarts the daemon
  6. Relaunches the app

You can also trigger an update manually from About -> Force update.

Uninstalling

# Stop and remove the daemon service
sudo systemctl stop uxtu4linux.service
sudo systemctl disable uxtu4linux.service
sudo rm /etc/systemd/system/uxtu4linux.service
sudo systemctl daemon-reload

# Remove app files
sudo rm -rf /opt/uxtu4linux
sudo rm /usr/local/bin/uxtu4linux

Clone this wiki locally