⚠️ Important Compatibility Note
Xtream UI was originally built for Ubuntu 18.04. Installing it on Ubuntu 20.04 requires extra steps because Python 2 support was dropped in newer Linux versions. Follow this guide carefully to ensure it works.
1Step 1: Preparing Ubuntu 20.04
Since Ubuntu 20.04 comes with Python 3 by default, and Xtream UI relies on Python 2, we first need to install the legacy Python environment.
Login to your server as root and run these commands:
This tricks the system into using Python 2 when the installer asks for "python", preventing installation errors.
2Step 2: Installing Dependencies
Next, we need to install specific libraries that might be missing on the newer OS.
3Step 3: Running the Installer
Now we can download and run the mirror installation script. This script connects to a mirror server since the original official servers are offline.
Copy and paste this command:
During Installation:
- Select MAIN when the menu appears.
- Choose Yes to configure MySQL.
- Set a MySQL password (write it down!).
4Step 4: The Critical Update (R22F)
The installer usually gives you an older version (R22E). You must update to R22F immediately to fix bugs, especially on Ubuntu 20.04.
Run this update block:
Then run the cleanup command:
5Step 5: Final Fixes
Finally, apply the GeoLite2 fix to ensure your streams work correctly.
You can now access your panel at http://your-server-ip:25500.
