How to Set Up XUI One Panel: Complete Beginner's Guide for

Setting up XUI One panel is the first step to running a professional IPTV service. This complete guide walks you through installation, configuration, and optimization — from bare metal server to serving your first customer.

Before You Start: Requirements

Server Requirements

OS: Ubuntu 20.04 or 22.04 LTS (recommended)
CPU: Minimum 4 cores (8+ recommended for 500+ users)
RAM: Minimum 8GB (16GB+ recommended)
Storage: 50GB+ SSD (more for catch-up/VOD content)
Bandwidth: 1Gbps minimum
IP: Dedicated IPv4 address

What You'll Need

SSH access to your server (root or sudo user)
A valid XUI One license
Domain name (optional but recommended)
Content sources (stream URLs from your content provider)

Step 1: Server Preparation

Update Your System

Start with a fresh, updated server. Connect via SSH and run the initial updates:

apt update && apt upgrade -y

Set Your Timezone

Configure the correct timezone for your server:

timedatectl set-timezone UTC

Using UTC is recommended for consistency, especially if you serve customers across multiple time zones.

Configure Firewall

Open the necessary ports for XUI One:

Port 80: HTTP (web panel)
Port 443: HTTPS (secure web panel)
Port 8000: Default streaming port
Port 8080: Alternative streaming port
Port 25461: XUI One API port

Your hosting provider's firewall or iptables should allow these ports.

Step 2: XUI One Installation

Download the Installer

Download the official XUI One installer script from your license portal. The installation process is automated:

chmod +x install.sh
./install.sh

The installer will:

Install all required dependencies (Nginx, MySQL/MariaDB, PHP, FFmpeg)
Configure the web server
Set up the database
Create the admin account
Start the XUI One services

First Login

After installation completes, you'll see your admin panel URL and default credentials. Access your panel at:

http://YOUR_SERVER_IP:8080

Important: Change the default admin password immediately after your first login.

Step 3: Initial Configuration

Panel Settings

Navigate to Settings > General and configure:

Server name: A descriptive name for this server
Server URL: Your domain or IP address
Default timezone: Match your target audience
Max connections per user: Set a reasonable default (1-2 for basic, 3-5 for premium)

Security Settings

Under Settings > Security:

Enable HTTPS (upload or generate an SSL certificate)
Set session timeout to 30 minutes
Enable IP-based admin access restrictions if you have a static IP
Configure brute-force protection (max login attempts)

Database Optimization

For better performance, especially as you grow, optimize your MySQL configuration:

Key settings to adjust in your MySQL configuration:

innodb_buffer_pool_size: Set to 50-70% of available RAM
max_connections: Set to 500+ for production use
query_cache_size: 64MB minimum

Step 4: Adding Content

Stream Categories

Organize your content into logical categories:

Go to Categories in the admin panel
Create categories for your content structure (e.g., Sports, Entertainment, News, Movies)
Assign a category order for how they appear in apps

Adding Streams

For live TV streams:

Go to Streams > Add Stream
Enter the stream source URL
Assign to a category
Configure stream settings (output format, transcoding options)

For Video on Demand:

Go to VOD > Add Movie/Series
Upload or link your content
Add metadata (title, description, poster image)
Assign to categories

Bouquet Configuration

Bouquets are packages of channels/content that you assign to customer accounts:

Go to Bouquets > Create Bouquet
Name your bouquet (e.g., "Basic Package", "Premium Package", "Sports Add-on")
Select which streams and VOD content to include
Save the bouquet

Create multiple bouquets for different pricing tiers. For example:

Basic: 500 channels, no VOD
Standard: 1,000 channels + basic VOD
Premium: All channels + full VOD + catch-up TV

Step 5: EPG (Electronic Program Guide) Setup

EPG data provides the TV guide information that customers see in their apps.

Adding EPG Sources

Go to EPG > Sources
Add your EPG XML/XMLTV source URL
Set the update interval (every 12 or 24 hours)
Map EPG channels to your streams

EPG Mapping Tips

Use auto-mapping first — it catches most matches
Manually map any remaining channels
Test EPG display in a player app before launching
Set up daily auto-updates to keep the guide current

Step 6: User and Reseller Setup

Creating User Accounts

For manual user creation:

Go to Users > Add User
Set username and password (or auto-generate)
Select the bouquet(s) to assign
Set max connections and expiry date
Choose output format (HLS recommended for compatibility)

Setting Up Resellers

To enable reseller sales:

Go to Resellers > Add Reseller
Set reseller credentials and credit allocation
Define which bouquets the reseller can sell
Configure reseller-specific pricing
Set credit costs per package type

Automating User Management

Manual user creation doesn't scale. Connect a billing platform to automate:

Account creation on payment
Automatic renewals and extensions
Suspension on non-payment
Self-service for customers

See our XUI One billing automation guide for step-by-step setup instructions.

Step 7: Multi-Server Setup (Optional)

For larger operations, XUI One supports multi-server deployments:

Load Balancer Configuration

Set up your main server as the admin/database server
Add additional servers as streaming nodes
Configure load balancing rules (round-robin, least connections, or geographic)

Adding a Streaming Node

Install XUI One on the new server
In the main admin panel, go to Servers > Add Server
Enter the new server's IP and credentials
Assign streams to the new server
Configure failover settings

Geographic Distribution

Place servers close to your customer base:

European customers → EU-based servers
North American customers → US/Canada servers
Asian customers → Singapore/Japan servers

This reduces latency and improves streaming quality significantly.

Step 8: Testing and Launch Preparation

Test Checklist

Before going live, verify:

[ ] All streams are playing correctly
[ ] EPG data is loading and displaying
[ ] User accounts can connect and authenticate
[ ] Multiple connections are handled correctly
[ ] VOD content plays smoothly
[ ] Admin panel is accessible and responsive
[ ] SSL certificate is working (if configured)
[ ] Backup system is configured and tested

Performance Testing

Simulate load before launch:

Create 50-100 test accounts
Use automated tools to simulate concurrent connections
Monitor server resource usage during the test
Identify and fix bottlenecks before real customers connect

Backup Configuration

Set up automated backups:

Database backup: Daily (store off-server)
Configuration backup: After every major change
Full server snapshot: Weekly

Step 9: Connecting Billing Automation

The final and most important step for a professional operation is connecting billing:

Choose a billing platform — IPTVbp is purpose-built for IPTV panels including XUI One
Connect the API — Enter your XUI One URL and admin credentials
Create products — Map your bouquets to sellable products with pricing
Set up payment gateways — Connect Stripe, PayPal, crypto, or other payment methods
Launch your storefront — Your customers can now purchase, pay, and get instant access

With billing connected, your XUI One panel goes from a streaming server to a fully automated business that can handle thousands of customers with minimal manual intervention.

Troubleshooting Common Issues

Panel not accessible after installation: Check that ports 8080 and 443 are open in your firewall. Verify Nginx is running with systemctl status nginx. Streams buffering or not loading: Check your source URLs are active. Verify server bandwidth isn't saturated. Try a different output format (HLS vs MPEG-TS). EPG not updating: Verify your EPG source URL is accessible from the server. Check the scheduled task is running. Clear the EPG cache and force a manual update. High CPU usage: Check for transcoding streams (they're CPU-intensive). Disable transcoding for streams that don't need it. Consider adding more servers for load distribution. Database errors: Check MySQL is running and has enough memory allocated. Verify the database isn't running out of connections. Optimize tables if the database is large.

Explore more guides to help you grow your IPTV business:

FAQ

Q: How many concurrent users can one XUI One server handle? A: A well-configured server with 8 cores and 32GB RAM can typically handle 2,000-3,000 concurrent streams without transcoding. With transcoding enabled, expect 200-500 concurrent streams depending on quality settings. Q: Do I need a domain name for XUI One? A: Not strictly, but it's strongly recommended. A domain with SSL makes your service look professional and is required for HTTPS. Q: Can I install XUI One on a VPS or does it need a dedicated server? A: XUI One works on VPS, but dedicated servers offer better and more consistent performance. For production use with 500+ customers, a dedicated server is recommended. Q: How do I update XUI One? A: Updates are typically applied through the admin panel or by running the update script provided by XUI One. Always back up before updating. Q: Can I use XUI One with Cloudflare? A: You can use Cloudflare for your admin panel and customer portal, but streaming traffic should NOT go through Cloudflare as it violates their ToS and will cause buffering issues.