Preloader
Official Migration Guide

Migrate XtreamUI / XUI / NXT to Xtream-Masters OTT Panel

The official two-method migration process straight from the Xtream-Masters panel documentation. Step-by-step, with the exact commands, paths, and tabs you will see inside the CMS.

Table of Contents

What the Migration Actually Transfers

Our migration system transfers everything — users, lines, bouquets, streams, movies, series, categories, resellers, settings and more. Only unnecessary old logs are skipped.

Supported source panels include XtreamUI, XUI (XUI.ONE), NXT, and other Xtream-Codes-family panels. The migration tool is built into the Xtream-Masters panel itself — no external scripts, no paid consultants, no API integration. It is part of your license.

Which Method Is Right for You?

There are two official migration methods. Pick based on where your new Xtream-Masters panel will run:

  • Method 1 New Server Migration — your Xtream-Masters main server is a different/new server from your old panel. Your old panel stays running during migration. This is the recommended path.
  • Method 2 Same Server Migration — you are installing Xtream-Masters on the same server where your old panel currently runs. The server OS will be wiped and reinstalled.

Method 1New Server Migration (Recommended)

Use this when your Xtream-Masters main server is a different/new server from your old panel. Your old panel stays running during migration.

1Add Your New Main Server in the CMS

Login to the Xtream-Masters CMS with your XM: account (xm:********), then add your new main server for installation. Wait for the CMS to complete the install.

2Click the “Migrate” Button on the Server Page

Once the install is finished, open the server page in the CMS and click the Migrate button. You will see two tabs — pick the one that fits your situation:

Option A: Remote Connection (direct DB access)

Use this if your old server's database port is accessible remotely.

  • Enter your old panel's database credentials: host, port, DB name, username, password.
  • Select the source panel type (XUI, NXT, XtreamUI, etc.).
  • Click Migrate — the system will connect to your old DB and copy the data automatically.

You don't need to upload any backup file with this option.

Option B: Database URL File (upload backup.sql)

Use this if your old server's database port is not accessible remotely, or if you prefer to use a SQL dump file.

  1. On your OLD server, export the database:
    mysqldump -u [username] -p [database_name] > backup.sql
  2. Upload the backup.sql file to your NEW Xtream-Masters server (not the old one!) at:
    /home/xtreamaster/wwwdir/backup.sql
    You can upload it via SCP, SFTP, or any file transfer method to the Xtream-Masters server.
  3. In the migration page, enter the file URL in this format:
    http://YOUR_SERVER_IP:STREAM_PORT/backup.sql
    The stream port can be found in /home/x_m/bin/nginx/conf/ports.conf on your Xtream-Masters server.
  4. Select the source panel type and click Migrate.

Important: Delete /home/xtreamaster/wwwdir/backup.sql after migration completes for security.

3Reset the Admin Password

Once migration completes:

  • In the CMS panel, click the admin password reset option (or use the reset link shown after migration).
  • Set your new admin password.

4Final Configuration

  • Go to the CMS dashboard, set the Panel Port, then login as admin.
  • Navigate to Settings → Update Tables — click the Update Tables button to finalize migration.

5Bring Servers Online

See Bringing Main & Load Balancers Online below — same steps apply to both methods.

Related FAQ: VODs not working after migration.

Method 2Same Server Migration (Reinstall)

Use this when you want to install Xtream-Masters on the same server where your old panel is currently running. The server will be wiped and reinstalled.

Warning: This method requires reinstalling your server OS. Make sure you have all backups before proceeding.

1Export the Database on the Current Server

mysqldump -u [username] -p [database_name] > backup.sql

2Download backup.sql to Your Local Computer

Important — the server will be wiped, so the backup must live off the server.

3Back Up Any Images and Files You Want to Keep

Logos, EPG files, custom branding assets, etc. These are not in the SQL dump.

4Reinstall the Server with Ubuntu 18.04 / 20.04 / 22.04

Clean OS install. Do not try to install Xtream-Masters on top of the old panel.

5Panel Configuration

  • Login to the Xtream-Masters CMS with your XM: account (xm:********).
  • Add your server for installation and wait for it to complete.

6Upload backup.sql to the Xtream-Masters Server

This is your same server, now freshly installed:

scp backup.sql root@YOUR_SERVER_IP:/home/xtreamaster/wwwdir/backup.sql

Or use SFTP / any file transfer tool to place the file at: /home/xtreamaster/wwwdir/backup.sql.

7Migration Process

  • Click Migrate on the server page → go to the Database URL File tab.
  • Enter the backup URL: http://YOUR_SERVER_IP:STREAM_PORT/backup.sql
  • Select the source panel type and click Migrate.

8Password Reset

  • Click the admin password reset option.
  • Set your new admin password.

9Final Configuration

  • Go to the CMS dashboard, set the Panel Port, then login as admin.
  • Navigate to Settings → Update Tables to finalize migration.

10Bring Servers Online

See next section.

Finalizing: Password Reset, Update Tables, Panel Port

These three steps are common to both methods and must be completed for the migration to be considered finished:

  1. Admin password reset. The old panel's hashes are preserved where possible, but you must explicitly reset the admin account from the CMS reset link.
  2. Panel Port. Set it in the CMS dashboard so the admin UI is reachable on the intended port. Remember this is separate from the stream port.
  3. Update Tables. After logging in as admin, go to Settings and click the Update Tables button. This finalizes schema mappings for the migrated data.

Bringing Main & Load Balancers Online

After the migration is finalized, bring your streaming infrastructure online:

Main Server

  1. Go to the Servers Page, edit the Main Server, set the SSH password.
  2. Navigate to Servers Page → click Main Option → Restart Service.

Load Balancers

  1. Edit each LB and set its SSH password.
  2. Navigate to Servers Page → click LB Option → Re-install Balancer.

Wait up to a couple of minutes for each load balancer to come online. Refresh the Servers page to confirm status.

After Migration: Fixing VODs & Movies

One thing the database migration does not automatically handle is the on-disk location of your VOD (movies and series) files, because every source panel uses a different folder layout. After the SQL migration completes, if you had locally-hosted VODs, you will need to move them.

Xtream-Masters stores all VODs (movies and series) in a single folder:

/home/xtreamaster/movies/

Typical source-panel VOD folders to migrate from:

  • XtreamCodes / XtreamUI / XUI: /home/xtreamcodes/iptv_xtream_codes/movies/
  • Other panels: check the old panel's config

Move the files and fix permissions:

mv /home/{old_panel_path}/vod_folder/* /home/xtreamaster/movies/ chown -R xtreamaster:xtreamaster /home/xtreamaster/movies/
Do NOT re-encode after moving files unless your original source URLs are no longer valid. The file-move method preserves your locally-hosted content without reprocessing. Only use the re-encode method if you originally imported VODs via server file paths AND those source URLs are still accessible.

If you re-encoded instead of moving, the panel's Movies/Series pages will kick off re-processing automatically for entries that still have valid source URLs.

Quick Summary Table

Migration Method Where Does backup.sql Go?
Option A — Remote Connection No backup file needed — system reads directly from your old database.
Option B — Database URL File Upload to /home/xtreamaster/wwwdir/backup.sql on your Xtream-Masters server (the destination server where the panel was installed).
Method 2 — Same Server Same as Option B — upload to /home/xtreamaster/wwwdir/backup.sql after the fresh OS install.
That is the entire official process. Two methods, two tabs in the Migrate button, one Update Tables click, plus SSH password + Restart/Re-install on the Servers page. No external tools, no hand-edited SQL, no risk of partial imports.

Migration Is Included. Licenses Start at €39.99.

The Migrate button is built into every Xtream-Masters install. No consulting fees, no per-row charges. Remote DB or SQL dump — whichever fits your situation.

One-Click Migration

Xtream-Masters OTT Panel

The Migration Target of Choice

Automatic importers for XtreamUI, XUI, NXT, XtreamCodes and other IPTV panel databases. Full preservation of users, lines, bouquets, streams, movies, series, categories, resellers, and settings.

Buy Pro License Official FAQ
Xtream-Masters Migration Tool
Get License Instantly
IPTV Admin Panel €39.99/Month
  • Migrate button built into every install
  • Remote DB connection OR SQL URL file
  • Users, lines, bouquets, VODs, resellers — all preserved
  • Ubuntu 18.04 / 20.04 / 22.04 supported
  • No consulting fees, no add-on costs

Retire the Legacy Panel

Get Your License Now
Support Center

Xtream-Masters Migration FAQ

The questions we get most about the official migration process.

All
Method Choice
Process
VODs / Media
01

Should I pick Method 1 or Method 2?

Method 1 (New Server) is recommended. Your old panel stays running, which means zero downtime for subscribers during the technical work. You only cut over (DNS flip) when you are sure the new panel is healthy. Method 2 (Same Server) is only needed when you cannot provision a new server.

02

When should I choose Option A (Remote Connection) vs Option B (SQL File)?

Pick Option A if your old server's MySQL/MariaDB port is reachable from the new server over the internet (or a private link). The panel reads directly and you skip the file upload. Pick Option B if MySQL is firewalled off, or if you simply prefer working with a SQL dump. Both produce identical end results.

03

Where do I find my stream port for the backup.sql URL?

On your Xtream-Masters server, it is in /home/x_m/bin/nginx/conf/ports.conf. Grep that file and use the stream port in the URL: http://YOUR_SERVER_IP:STREAM_PORT/backup.sql.

04

What is an “XM: account”?

The XM: account is your top-level Master CMS login (format: xm:********) that you use to add and manage servers in the Xtream-Masters CMS. It is separate from the per-panel admin login you reset after migration. You get it when you purchase your license.

05

What is the “Update Tables” button for?

Update Tables in Settings is the final step that completes schema mappings for migrated data. Do not skip it — without this click, some settings and table joins remain in the source-panel layout and streams may show odd behaviour.

06

What gets migrated and what does not?

Migrated: users, lines, bouquets, streams, movies, series, categories, resellers, settings, and other first-class data. Skipped: unnecessary old logs (access logs, connection history tables) that are not useful to carry forward.

07

Do I need to restart my load balancers after migration?

Yes — after migration, go to the Servers Page, edit each LB, set its SSH password, then click Re-install Balancer. For the main server, set its SSH password and click Restart Service. This registers the servers under the new panel and starts serving streams.

08

My movies and series are not playing after migration - why?

The SQL migration does not move on-disk VOD files. Xtream-Masters stores all movies and series in /home/xtreamaster/movies/. Move the files from the old panel path (e.g. /home/xtreamcodes/iptv_xtream_codes/movies/) and fix ownership: chown -R xtreamaster:xtreamaster /home/xtreamaster/movies/. Do not re-encode if your files are already local.

09

Should I delete backup.sql after migration?

Yes. For Option B, delete /home/xtreamaster/wwwdir/backup.sql after the migration completes. Leaving a public SQL dump of your whole user database in wwwdir is a security risk.

10

Is there an official Xtream-Masters FAQ I can bookmark?

Yes — the official FAQ for migration lives here: ottpanel.tv/faqs?search=how+to+migrate+to+xtream-masters+ott+panel. This article follows that process exactly.

Migrate Tonight. Grow Tomorrow.

Official migration tooling included with every Xtream-Masters license.

Purchase License - €39.99/Month Official FAQ
Important Legal Notice
Xtream-Masters is a software development company. We build and license professional software tools — we do not host, store, stream, index, or distribute any audio, video, playlist, channel, or DRM-protected content of any kind. Every product we sell is an empty technical platform; all content processed through our software is supplied, configured, and controlled solely by the end user, who must hold the necessary rights and comply with applicable law. Copyright or DMCA notices must be directed to the operator or stream origin of the URL concerned — not to Xtream-Masters. See our Terms, Privacy Policy, and Refund Policy for full details.