Frequently Asked Questions

How to migrate to Xtream-Masters OTT Panel

There is two way to migrate your IPTV Panel in the most reliable Xtream-Masters Panel.

#New server migration.


  1. Login to your Xtream-Masters CMS cPanel with ID that start from XM: xm:********, then add the main server for installation.
  2. Once installation process complete:
    • Click Migrate button
    • Insert database credentials
    • Ensure SSH port accessibility
    • Wait for migration completion
    • Alternative: Upload SQL dump file
  3. Password Reset after migration complete:
    • Click menu → admin password reset option
    • Update admin credentials
  4. Final Configuration:
    • Goto cms dashboard, Set Panel Port and Login Panel as admin
    • Navigate to Settings → Click update tables button
🚀 Now Bring Servers Online.
Main Server
  1. Goto Servers Page, Edit Main Server Set SSH Password
  2. Navigate to: Servers Page → Click Main Option → Restart Service
Load Balancers
  1. Edit Each LB Set SSH password
  2. Navigate to: Servers Page → Click LB Option → Re-install Balancer

#Existing server migration.


  1. Database Backup:
    mysqldump -u [uname] -p db_name > db_backup.sql
  2. Download backup file locally
  3. Backup server images/files
  4. Reinstall server with Ubuntu 18.04 / 20.04 / 22.04
  5. Panel Configuration:
    • Login to Master CMS (xm:********)
    • Add server for installation
  6. Upload backup to /home/xtreamaster/wwwdir
  7. Migration Process:
    • Navigate to Migrate → Migrate by URL
    • Input backup file URL
  8. Password Reset after migration complete:
    • Click menu → admin password reset option
    • Update admin credentials
  9. Final Configuration:
    • Goto cms dashboard, Set Panel Port and Login Panel as admin
    • Navigate to Settings → Click update tables button
🚀 Now Bring Servers Online.
Main Server
  1. Goto Servers Page, Edit Main Server Set SSH Password
  2. Navigate to: Servers Page → Click Main Option → Restart Service
Load Balancers
  1. Edit Each LB Set SSH password
  2. Navigate to: Servers Page → Click LB Option → Re-install Balancer

How change main server

  1. Take your main server images or any important files backup.
  2. Log in to the admin ID:
    • Go to the Backup section
    • Click the Generate Backup Now button
    • Download latest backup file from: /home/xtreamaster/backups/
  3. Server Migration:
    • Login to Master CMS cPanel (ID: xm:********)
    • Delete existing server
    • Input new server SSH details
    • Wait for installation completion
  4. Backup Restoration:
    • Upload *****.sql.gz to /home/xtreamaster/backups/
    • Login with admin/admin credentials
    • Navigate to Backup section
    • Click Restore Backup button
  5. Update Server IP:
    • Login to Xtream-Masters CMS cPanel (ID: xm:********)
    • Update main server IP with new server
  6. Troubleshooting Load Balancers:
    • Navigate to Manage Server section
    • For each load balancer:
        Click option button
        Select Restart Service
    • Wait up to 2 minutes for load balancer become online.

How change panel port

    Port Change
    To change panel default port 7709
    • Login to Xtream-Masters CMS cPanel (ID: xm:********)
    • In dashboard Click Edit Port Button
    • Set New port Make sure not already used by any other service Then click Save button
    • Approximately 2 minutes will take to apply changes and You all Done.

How to change existing main server IP

  1. Method 1
    • Login to Master CMS cPanel (ID: xm:********)
    • Edit Main server
    • Set New IP And Click Save
  2. Method 2
    • Login to Master CMS cPanel (ID: xm:********)
    • Download Config Backup
    • Update IP And Restore Config.
  3. Update Main Server IP In DNS.
  4. Troubleshooting Load Balancers:
    • Navigate to Manage Server section
    • For each load balancer:
        Click option button
        Select Restart Service
    • Wait up to 2 minutes for load balancer become online.

Server Disk Full Problem (Simple find way)

  1. Login SSH
    • Go to: `/home/x_m/bin/nginx/logs/` to clear log files.
    • Use command: df -h to check the overall disk usage and status.
    • Use command: du -sh /home/* to check the size of each folder in the home directory.
    • Identify which folder is using the most disk space.
    • If you need more detail, navigate into the large folders with: du -sh /home/your-folder/* to list individual file sizes.

Server Disk Full Problem (Advanced find way)

  1. Check Overall Disk Usage
    • Run df -h to see disk usage across all mounted filesystems
    • Look for /home or root (/) filesystems with high %Use
  2. Identify Large Directories
    • Check /home directory size: du -sh /home
    • List directories sorted by size:
      du -sh /home/* | sort -rh
    • Drill down into large directories:
      cd /path/to/large-dir && du -sh * | sort -rh
  3. Find Large Files
    • Find files larger than 1GB:
      find /home -type f -size +1G -exec ls -lh {} \;
    • Sort files by size in current directory:
      ls -lahS
  4. Common Cleanup Targets
    • Clear old log files: /var/log and application log directories
    • Check for core dumps: find / -name core -size +100M
    • Clean package cache: apt-get clean or yum clean all

Troubleshooting FAQs

  • Check disk space:
    df -h - Shows usage by filesystem
  • Find directory sizes:
    du -sh /* - Check top-level directories
    du -h --max-depth=1 /path - Limit directory depth
  • Deleted files still in use?
    Check with lsof +L1 - Shows deleted files held by processes
  • Quick space check:
    ncdu - Interactive disk usage analyzer (may need to install)
Safety Tips:
  • Always backup before deleting critical files
  • Use log rotation for application logs
  • Consider compressing old files instead of deleting

How to enable root access

UBUNTU
🔐 SSH Root Access Configuration

#If you have an Ubuntu server and the SSH login comes with the "ubuntu" username, you can change the "ubuntu" user to the "root" user by following this setup.

  1. #open putty program and login as `ubuntu` user then run following cmds.
    sudo -i
  2. # now run passwd command and set new password for `root` user.
    root@server:~#
    passwd
  3. #now run these commands.
    apt-get install wget -y wget -O "/etc/ssh/sshd_config" "https://xtream-masters.com/files/tutorials/ROOT-ENABLE.git" service sshd restart reboot

#Congratulations on your Ubuntu server setup! Your server is now accessible by the root user using the password you have just set.

Mysql database connection failed problem

If you getting Mysql database connection failed message while to login panel, you can follow these setups.

1 - Log in to your main server using the 'PuTTY' program and run this command.

sudo service mysql restart

How to reset admin id password

If you forget or lose admin access follow the setups.

  1. 🔑 Admin Recovery: Log in to your master cms Cpanel id that starts from xm:
    → Click Reset admin access in narbar menu
    → Change the admin id password

Server bandwidth not showing

If any server (balancer) bandwidth not showing follow the setups.

  1. 🔑 Admin: Log in to your admin panel id.
    → Menu Manage server page then edit the spacific server
    → Goto Advance tab
    → Select Correct Network interface and save it

Admin And Reseller Panel port not working.

If you are encountering issues with the admin and reseller panels not functioning, even though your main server and live stream is up and running, please follow the steps below to resolve the problem.

🔑

CMS Admin

Log in to your cms admin panel id that start from xm:******

→ Check what the port is set to for the admin and reseller panel
→ Try accessing panel directly: http://{your_server_ip}:{panel_port}

If still not working (port conflict solutions):

1 Disable panel port that using by other service that you need to check and change
2 Change panel port from master cms panel

How to active phpmyadmin

  1. 🔧 Server Setup:

    Login your main server putty and run the provided cmd below.

    wget -O "/home/xtreamaster/wwwdir/adminer_584437.php" https://github.com/vrana/adminer/releases/download/v5.0.1/adminer-5.0.1-en.php
  2. 🌐 Access Adminer:

    Now access adminer by this link →

    http://ottpanel.tv:{streaming_port}/adminer_584437.php?server=127.0.0.1:7999
  3. 🔑 Database Access:

    Now login into your Master CMS cPanel with ID that start from XM: to get your database login info.

ℹ️ Info: Adminer is one file advanced MySQL manager - more powerful, secured and optimized.

Main Server or Load-Balancer Service Down

  1. ⚙️ Configuration Update:

    Goto settings page and click Update Tables button.

  2. 🚀 Now Bring Servers Online.
    Main Server
    1. Goto Servers Page, Edit Main Server Set SSH Password
    2. Navigate to: Servers Page → Click Main Option → Restart Service
    Load Balancers
    1. Edit Down LB Set SSH Password (if not set already)
    2. Navigate to: Servers Page → Click LB Option → Restart Service (OR) Re-install Balancer

🚨 After migration: If any LB fails to come online:

  • Disable previous installation by removing corresponding folder from /home/ dir
  • Reboot the server

⛑️ Advanced Debugging:

If still remain down, trace the error by run command in effect server putty:

root@server:~#
bash /home/xtreamaster/start_services.sh

Main Server Down or Load-Balancer Down

If your main server is down

  1. Manage servers–> edit main server–> check ports and put again your ssh password–> save–> full reload
  2. Check if any proxy cut down connection between your main and Client connection
  3. Check if you can access ssh
  4. Once enter ssh run : df –h to check if you have any 100% full folder
  5. If yes delete and create some free space
  6. Run service mysql restart and wait for your server to respond, after that check if you can access your panel again
  7. Run /home/xtreamaster/start_services.sh and check what error you get. Most of the times this error will guide you on what to do next.
  8. As a final solution, reboot your main server

If your load balance is down

  1. Check if you can access ssh
  2. Once enter ssh run: df –h to check if you have any 100% full folder
  3. If yes delete and create some free space
  4. Run /home/xtreamaster/start_services.sh and check what error you get. Most of the times this error will guide you on what to do next.
  5. As a final solution, reboot your load balancer
  6. Reduce the server load

Vods not working after migration

If you have VODs not working after migration that's normal becouse of core change you need re-encode agian, for that we've created an automated one-click tool that you can use.

My server under ddos attack

    If your main server Request per sec: 500 above, your server is under ddos attack, follow below the steps to protect your server.

  1. Menu → Manage server page
    • Edit main server
    • Goto Server Guard tab
    • Enable Server Guard
    • Enable i'm under attack mood
    • Read the all avaliable option with full attention and do config then save it.
  2. Admin Profile → Goto General Settings Page
    • Click Xtream Tab
    • Disable XML EPG - ON
    • Disable Player_API EPG - ON
    • And Save Config.
  3. Admin Profile → Goto General Settings Page
    • Click BruteForce Attacks Tab
    • Enable All Checkbox
    • Requests Amount for Blacklist 25
    • In Seconds 5
    • Requests Within Seconds 10
    • Flood Limit 30
    • And Save Config.

    4. Note: monitor blocked ip page if you found any restreamer ip blocking as well adjust the config accordingly

How to change vod server after transfer files to another server

    If you want to change the VOD server by transferring files to the new load balancer, follow these three easy steps. (Make a database backup so any mistakes can be easily undone.)

  1. Menu → Mass Tools → Streams Tools
    • DNS Replacement Tab
    • OLD String example → s:123:/home/your_folder
    • New String example → s:150:/home/your_folder
    • This Will replace server ids in movies, episodes path.
  2. Menu → Movies / Epsiodes → Mass Edit
    • Select Moved Content
    • Select New Server And Save it.
  3. Menu → Mass Tools → Advanced Tools
    • Proceed Mass Encoding.

0 Connection On LB

  1. If you install a new load balancer server and you see that even if clients are inside, connections are zero, you need to enter follow cmd in your main server SSH:
    root@server:~#
    sudo -u xtreamaster /home/x_m/bin/php/bin/php /home/xtreamaster/tools/connection_handler.php >/dev/null 2>/dev/null &

Episode order lost after migration from xui

If you are experiencing the same issue, please run the following query to resolve it:

UPDATE series_episodes AS se SET se.sort = se.episode_num;

take database backup first.

Stream not working in user side

Here you will get some suggestions until you learn how to use the panel. Same suggestions are applied for reports like:

  • Clients cannot connect to stream
  • Clients are blocked from stream
  • PANEL SLOW
  1. In general settings menu–> security turn OFF or NO these options:
    • Override Client's Country upon first connection
    • Verify Client-IP During Load Balancing
    • Disallow connections with empty user agent
    • Don't allow connections from Different IPs while User is online
    • Enable ISP Lock Mode
    • Disallow Following Proxy Types Connections UN-SELECT THEM ALL
    • Allow connections from these countries transfer all countries on the right side
  2. In general settings menu–> Anti-Abuse/BruteForce Attacks turn everything to “NO”. Delete all blocked IPs from security plug-ins. Delete all blocked subscriptions from logs–> Abused Subscriptions
  3. In general settings menu–> Performance Turn everything to “NO” except the Save Error Client Log so you can check any error log from client req. logs menu.
  4. In general settings menu–> Stalker Portal
    • UN-select all the images in that menu. Please DO NOT select any image from the Lock STB To Images otherwise you will block the other clients!
    • Check your “allowed stb types” and transfer everything to the right side.
    • Increase MAG Security set this to “NO”
  5. In general settings menu–> Streams Put the default values as suggested in “i” icon.
  6. In general settings–> steraming and client settings
    • Balance Connections by set this to Number of connections
    • Prebuffer enable for Restreamers Set this To “NO”
    • Use Buffer to store the Data Before Sending them to client Set to “NO”
  7. In TOOLS run:
    • Reset Country restriction for all subscriptions
    • Remove Network Logs (RUN THIS OFTEN)
    • Remove MAG Lock
    • Reset all ISPs
    • Delete closed connections
  8. In manage servers menu, check the servers max allowed connections. Do NOT have them in 0!
  9. Please note that you MUST clear your panel logs very often

Reboot main server also helpful, If problem in spacific Load-balancer, Goto servers page –> Click LB Option –> Click Re-install Balancer

All Stream down in specific load balancer

#If a specific load balancer has all streams and the created channels are down, it may be due to the default version of FFmpeg (v6) not being supported by the operating system. You can resolve this issue by switching to FFmpeg version v5.


FFmpeg - v5
Supported OS ubuntu 18.04 / 20.04 / 22.04 x86 arch.
root@server:~#
apt update && apt upgrade -y && apt install curl -y && curl -o ffmpegv5.sh -L https://paksat.pk/iptv/cms/ffmpeg/ffmpeg5/ffmpeg.xsh && bash ffmpegv5.sh


FFmpeg - v6
Supported OS ubuntu 18.04 / 20.04 / 22.04 / 24.04 x86 arch.
root@server:~#
apt update && apt upgrade -y && apt install curl -y && curl -o ffmpegv6.sh -L https://paksat.pk/iptv/cms/ffmpeg/ffmpeg6/ffmpeg.xsh && bash ffmpegv6.sh

#Restart Balancer service to start all ffmpeg process with current setup version.