Xtream UI remains one of the most popular free choices for managing IPTV services. If you are just starting out and don't have a huge budget for premium panels, this is a great place to start. While it might seem complicated at first, installing it is actually quite straightforward if you follow the steps below.
1Getting Your Server Ready
Before we type a single command, you need to make sure your environment is correct. Xtream UI is very specific about what it needs.
- Operating System: You strictly need Ubuntu 18.04 LTS. Do not try this on Ubuntu 20.04 or 22.04, as the dependencies for the free version of Xtream UI are quite old and won't work on newer systems.
- Tools: You will need PuTTY (to run commands) and WinSCP (to transfer files) installed on your computer.
2Enabling Root Access
Most server providers today give you a custom username (like ubuntu or azureuser) instead of the root user for security reasons. However, Xtream UI needs full root access to install correctly.
If you aren't logged in as root, login with your default user and run:
Now, let's enable direct root login so you don't have issues later. Open the SSH config file:
Look for the line that says PermitRootLogin prohibit-password or similar. Change it to:
Press CTRL+X, then Y, then Enter to save. Finally, restart the SSH service and set a root password:
3Running the Installation Script
We will use a mirror script that automates downloading all the necessary files. Since the original Xtream Codes servers are down, these mirrors act as the source.
Copy and paste this entire command into PuTTY:Once the script starts, you will see a menu. Here is what to do:
- Type MAIN and press Enter (this installs the Admin panel).
- When asked to configure MySQL, choose Y (Yes).
- It will ask for a MySQL password. Type any password you like (e.g.,
12345) and save this password safely.
When it finishes, it will show you your panel URL, usually http://your-ip:25500.
4Updating to Version R22F
The default installer usually installs version R22E. To get the latest features and bug fixes (Version R22F), you need to run an update command immediately after installation.
After the files are copied, run this final cleanup command to set permissions and restart services:
5Essential Fixes (Don't Skip This!)
There is a known bug where the GeoLite2.mmdb file (used for identifying user countries) gets corrupted or deleted, causing streams to stop working. Run this fix to download a fresh copy and lock it so it cannot be deleted:
admin / Pass: admin.
