Getting Started

This guide will walk you through setting up XUIONE WebPlayer Pro and adding your first IPTV server.

Requirements

Server Requirements

XUIONE WebPlayer Pro requires a Linux server or VPS with the following minimum specifications:

Supported Operating Systems

Software Dependencies

The following packages are required and will be installed automatically by the install script if missing:

Network Requirements

• Port 80 (HTTP) must be available — or choose a custom port during installation
• Outbound internet access for downloading packages and connecting to IPTV servers
• Optional: Port 443 (HTTPS) if using SSL with a domain

Installation

Quick Install (Recommended)

Download and run the installer on your server with your license key:

# Download the installer
curl -Lo install https://xuiwebplayer.com/api/installer/binary?arch=amd64
chmod +x install

# Install with your license key
sudo ./install --license XXXX-XXXX-XXXX-XXXX

The installer will:

1. Verify your license key with the license server
2. Detect your operating system and version
3. Check and install any missing dependencies (Node.js, Nginx, ffmpeg)
4. Download the latest release (license-protected)
5. Install to /opt/xuione-webplayer-pro
6. Auto-configure your license key
7. Configure Nginx as a reverse proxy
8. Create and start a systemd service

ARM64 Install

For ARM64 servers (Raspberry Pi, AWS Graviton):

# Download ARM64 installer
curl -Lo install https://xuiwebplayer.com/api/installer/binary?arch=arm64
chmod +x install

# Install with your license key
sudo ./install --license XXXX-XXXX-XXXX-XXXX

Docker Install

You can also run XUIONE WebPlayer Pro using Docker:

# Using Docker Compose (recommended)
docker compose up -d

# Or using Docker directly
docker build -t xuione-webplayer-pro .
docker run -d -p 8080:80 --name xuione-webplayer-pro xuione-webplayer-pro

The Docker container exposes port 80 internally, mapped to port 8080 on the host by default.

Managing the Service

After installation, the application runs as a systemd service:

# Check status
sudo systemctl status xuione-webplayer-pro

# Start / Stop / Restart
sudo systemctl start xuione-webplayer-pro
sudo systemctl stop xuione-webplayer-pro
sudo systemctl restart xuione-webplayer-pro

# View logs
sudo journalctl -u xuione-webplayer-pro -f

Uninstall

To completely remove XUIONE WebPlayer Pro:

sudo bash /opt/xuione-webplayer-pro/install.sh -u

First Login

When you first open XUIONE WebPlayer Pro, you'll see the welcome screen prompting you to add a server.

Initial startup screen — No servers added yet

Click "+ Add Your First Server" or the "+ Add Server" button to begin.

Adding a Server

Step 1: Select Provider Type

XUIONE WebPlayer Pro supports two provider types:

Provider type selection dropdown

Step 2: Enter Server Credentials

Fill in the following information:

Step 3: Residential Proxy (Optional)

If your IPTV provider blocks VPS or datacenter IPs, you can configure a residential proxy.

Proxy configuration with successful test

Supported proxy formats:

http://host:port
http://user:pass@host:port
socks5://user:pass@host:port

Click "Test Proxy" to verify the connection. A successful test shows the exit IP and response time.

Server Compatibility Check

After entering your credentials and clicking "Add Profile", XUIONE performs a comprehensive compatibility check.

Check in Progress

Server compatibility check in progress

The system verifies:

Check Complete

All checks passed — Server is compatible

Once all checks pass, you'll see additional information about content compatibility (channels, movies, series, and format support).

Click "Add Server" to save the profile.

Server Selection

After adding one or more servers, you'll see the server selection screen.

Server selection screen with online status

Server Card Information

Click a server card to connect and enter the Dashboard.

What's Next?

After selecting a server, you'll be taken to the Dashboard where you can:

• Browse Live TV channels
• Explore the movie library
• Watch TV series
• Access the TV Guide