Linux Troubleshooting

Linux Troubleshooting

---

PermissionError on config.toml

The install directory is owned by root. This happens if the installer was run with sudo instead of as a normal user.

Fix:

sudo chown -R $USER:$USER /opt/uxtu4linux

---

dmidecode not found

sudo apt install dmidecode      # Debian / Ubuntu
sudo dnf install dmidecode      # Fedora / RHEL
sudo pacman -S dmidecode        # Arch
sudo zypper install dmidecode   # openSUSE

---

ryzenadj not found or not executable

chmod +x /opt/uxtu4linux/src/Assets/Linux/ryzenadj

If the binary is missing entirely, run About -> Force update to re-download a clean release.

---

Daemon not running

sudo systemctl status uxtu4linux.service
sudo systemctl start uxtu4linux.service

Check logs if it keeps failing:

journalctl -u uxtu4linux.service -n 50

Then from inside the app go to Settings -> Daemon Service -> Install & enable to reinstall the service.

---

Secure Boot blocking ryzenadj

ryzenadj requires the ryzen_smu kernel module when Secure Boot is on and Secure Boot blocks unsigned modules.

Option 1 - Disable Secure Boot in your UEFI firmware settings.

Option 2 - Sign the module with your MOK key:

# Install build deps (Fedora example)
sudo dnf install cmake gcc gcc-c++ dkms openssl
 
# Clone and install ryzen_smu
git clone https://github.com/amkillam/ryzen_smu
cd ryzen_smu
sudo make dkms-install
 
# Enroll the DKMS key
sudo mokutil --import /var/lib/dkms/mok.pub

Reboot - the system will enter MOK Manager. Choose Enroll MOK, enter the password you set, and reboot again.

Verify the module loaded:

sudo dmesg | grep ryzen_smu

A "kernel tainted" message is expected and harmless.

---

Wrong preset loading / CPU not detected

If dmidecode returned an unrecognised CPU name, manually set it in config.toml:

[Info]
cpu = AMD Ryzen 5 7535HS with Radeon Graphics

Use a known model string matching your actual hardware family. See Configuration for all [Info] keys.

---

Python version too old

UXTU4Linux requires Python 3.10+. Check your version:

python3 --version

Install a newer version:

# Ubuntu 20.04 (via deadsnakes PPA)
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt install python3.11 python3.11-venv
 
# Fedora / RHEL
sudo dnf install python3.11
 
# Arch (always ships latest)
sudo pacman -S python

Then re-run the installer.