How to Install XUI Panel on VPS: Complete Step-by-Step Guide 2026

How to Install XUI Panel on VPS: Complete Step-by-Step Guide 2026

Installing XUI panel on your VPS is the first step to starting your IPTV reseller business. This comprehensive 2026 guide will walk you through the entire process of installing and configuring XUI reseller panel on a VPS server, from initial setup to security configuration and WHMCS integration.

What is XUI Panel?

XUI panel (also known as XUI one) is a web-based IPTV reseller management system that allows you to create and manage IPTV accounts, subscriptions, and reseller accounts. It's one of the most popular IPTV panel solutions, especially when integrated with WHMCS XUI reseller modules for automated billing and account management.

VPS Requirements for XUI Panel Installation

Before installing XUI reseller panel, ensure your VPS meets these requirements:

System Requirements

• Operating System: Ubuntu 20.04, Ubuntu 22.04, Debian 10, or Debian 11
• RAM: Minimum 1GB (2GB+ recommended for better performance)
• CPU: 1 core minimum (2+ cores recommended)
• Storage: 20GB minimum (50GB+ recommended)
• Network: Stable internet connection
• Root Access: Required for installation

Recommended VPS Providers

• DigitalOcean (Ubuntu droplets)
• Vultr (High-performance VPS)
• Linode (Reliable infrastructure)
• AWS EC2 (Scalable solution)
• Hetzner (Cost-effective European option)

Step 1: Connect to Your VPS via SSH

First, connect to your VPS using SSH. If you're using Windows, use PuTTY or Windows Terminal. For Mac/Linux, use the built-in terminal:

ssh root@your-vps-ip-address

Replace your-vps-ip-address with your actual VPS IP address. Enter your root password when prompted.

Step 2: Update Your System

Before installing XUI panel, update your system packages:

# For Ubuntu/Debian
apt update && apt upgrade -y

# Install essential packages
apt install -y curl wget

Step 3: Install XUI Panel

XUI panel provides a convenient one-command installation script. Run the following command:

bash <(curl -Ls https://raw.githubusercontent.com/alireza0/x-ui/master/install.sh)

Alternative: Manual XUI Installation

If the automatic script doesn't work, you can install XUI panel manually:

# Clone XUI repository
git clone https://github.com/alireza0/x-ui.git
cd x-ui

# Run installation
chmod +x install.sh
./install.sh

Step 4: Access XUI Panel Web Interface

After installation completes, XUI panel will be accessible via web browser:

• URL: http://your-vps-ip:54321 or https://your-vps-ip:54321
• Default Username: admin
• Default Password: admin

Step 5: Configure XUI Panel Settings

Once logged into XUI reseller panel, configure the following settings:

5.1 Change Admin Credentials

1. Go to Settings → Account Settings
2. Change username from admin to a secure username
3. Set a strong password (minimum 12 characters, mix of letters, numbers, symbols)
4. Save changes

5.2 Configure Panel Settings

• Panel Port: Change from default 54321 to a custom port (optional but recommended)
• SSL Certificate: Enable SSL/TLS for secure connections
• API Settings: Configure API access for WHMCS XUI integration
• Reseller Settings: Enable reseller features if using XUI reseller panel

Step 6: Set Up SSL Certificate (Recommended)

For production use, secure your XUI panel with an SSL certificate:

Option A: Using Let's Encrypt (Free)

# Install Certbot
apt install -y certbot

# Obtain SSL certificate (replace with your domain)
certbot certonly --standalone -d xui.yourdomain.com

# Configure XUI to use SSL certificate
# Path: /root/certbot/conf/live/xui.yourdomain.com/

Option B: Using Cloudflare SSL

If you use Cloudflare, enable SSL/TLS encryption mode in Cloudflare dashboard and configure XUI panel to use Cloudflare's SSL.

Step 7: Configure Firewall

Secure your VPS by configuring the firewall to allow only necessary ports:

# Install UFW (Uncomplicated Firewall)
apt install -y ufw

# Allow SSH (important - do this first!)
ufw allow 22/tcp

# Allow XUI panel port (default 54321)
ufw allow 54321/tcp

# Allow HTTP/HTTPS
ufw allow 80/tcp
ufw allow 443/tcp

# Enable firewall
ufw enable

# Check firewall status
ufw status

Step 8: Create Your First XUI Reseller Account

Now that XUI panel is installed and configured, create your first reseller account:

1. Login to XUI reseller panel
2. Navigate to Inbounds → Add Inbound
3. Configure inbound settings:
   • Port: Choose an available port
   • Protocol: Select your preferred protocol (VMess, VLESS, Trojan, etc.)
   • Settings: Configure encryption and security settings
4. Go to Clients → Add Client
5. Enter client details and assign the inbound
6. Save and test the connection

Step 9: Integrate XUI Panel with WHMCS

To automate your IPTV business, integrate XUI reseller panel with WHMCS using WHMCS XUI reseller addons:

9.1 Where to Buy WHMCS XUI Reseller Module

Purchase the XUI Reseller Panel module from whmcsmodules.net:

• Product: XUI Reseller Panel
• Price: $199.00 (one-time license)
• Buy Link: https://whmcsmodules.net/clients/store/modules-whmcs/xui-reseller-panel
• License: Per domain allowed, lifetime updates included

9.2 Install WHMCS XUI Reseller Module

1. Purchase and download WHMCS XUI reseller module from whmcsmodules.net
2. Upload module files to /modules/servers/xui/ directory
3. Activate the module in WHMCS admin area

9.2 Configure WHMCS XUI Integration

1. Go to WHMCS Admin → Setup → Products/Services → Servers
2. Add new server:
   • Name: XUI Reseller Panel
   • Hostname: Your XUI panel IP or domain
   • Type: XUI Reseller
   • API Username: Your XUI panel admin username
   • API Password: Your XUI panel admin password
   • API Port: 54321 (or your custom port)
3. Test connection and save

9.3 Create WHMCS Product for XUI Services

1. Go to Products/Services → Products/Services
2. Create new product:
   • Product Type: Other
   • Module: XUI Reseller
   • Server Group: Select your XUI server
   • Package Configuration: Configure bandwidth, duration, and limits
3. Set pricing and save

Step 10: Test XUI Panel Installation

Verify that your XUI panel installation is working correctly:

10.1 Test Panel Access

• Access panel via web browser
• Login with your credentials
• Verify all menu items load correctly

10.2 Test API Connection

# Test XUI API from command line
curl -X POST http://your-xui-ip:54321/api/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"your-password"}'

10.3 Test WHMCS Integration

• Create a test order in WHMCS
• Verify automatic account creation in XUI reseller panel
• Test service suspension and reactivation
• Verify automatic renewals work

Common XUI Panel Installation Issues and Solutions

Issue 1: Installation Script Fails

Problem: Installation script returns errors or fails to complete.

Solution:

• Ensure you have root access
• Check internet connectivity: ping google.com
• Update system: apt update && apt upgrade -y
• Try manual installation method

Issue 2: Cannot Access XUI Panel

Problem: Cannot access XUI panel via web browser.

Solution:

• Check if XUI service is running: systemctl status x-ui
• Verify firewall allows port 54321: ufw status
• Check XUI logs: journalctl -u x-ui -f
• Verify correct IP address and port

Issue 3: API Connection Fails

Problem: WHMCS XUI integration cannot connect to XUI panel.

Solution:

• Verify API credentials in XUI panel settings
• Check API port is correct (default: 54321)
• Ensure firewall allows API port
• Test API connection manually using curl
• Check XUI panel logs for API errors

XUI Panel Security Best Practices

After installing XUI reseller panel, implement these security measures:

1. Change Default Credentials

Immediately change the default admin username and password after installation.

2. Enable SSL/TLS

Always use HTTPS for XUI panel access, especially in production environments.

3. Configure Firewall

Only allow necessary ports and restrict access to trusted IP addresses if possible.

4. Regular Updates

Keep XUI panel updated to the latest version for security patches:

# Update XUI panel
x-ui update

5. Backup Configuration

Regularly backup your XUI panel configuration:

# Export XUI configuration
x-ui export

Next Steps After XUI Panel Installation

Now that you've successfully installed XUI panel on your VPS, here's what to do next:

1. Configure Reseller Settings: Set up reseller accounts and limits
2. Integrate with WHMCS: Install WHMCS XUI reseller module for automation
3. Set Up Payment Gateways: Configure IPTV payment gateways in WHMCS
4. Create Product Packages: Define IPTV service packages and pricing
5. Test Complete Workflow: Test order → payment → account creation → service delivery

Conclusion

Installing XUI panel on your VPS is straightforward with the one-command installation script. This guide covered everything from VPS requirements to security configuration and WHMCS XUI integration. With XUI reseller panel properly installed and integrated with WHMCS, you can automate your entire IPTV business workflow.

Related Articles

• Buy XUI Reseller Panel: Start Your IPTV Business Guide
• XUI Reseller Panel WHMCS Integration Guide
• XUI Reseller Panel WHMCS Integration Setup
• IPTV Payment Gateway WHMCS Integration