How to Migrate from Xtream UI to XUI One Without Losing

Migrating your IPTV panel from Xtream UI to XUI One is a significant upgrade, but it requires careful planning to avoid service disruption. This comprehensive guide covers every step of the migration process, from preparation to post-migration optimization.

Why Migrate to XUI One?

Before diving into the how, let's confirm the why. Providers migrate from Xtream UI to XUI One for several key reasons:

Active development: XUI One receives regular updates and security patches, while Xtream UI updates are sporadic
Better API: Full REST API enables billing automation and custom integrations
Modern interface: Cleaner admin panel that's faster to work with
Improved performance: Better resource utilization, especially at scale
Official support: Paid support from the development team vs. community forums
Advanced reseller system: Credits-based reseller management with detailed reporting

If you're managing more than 200 customers on Xtream UI and planning to grow, the migration is well worth the short-term effort.

Pre-Migration Checklist

Data to Export from Xtream UI

Before touching anything, export all your data:

[ ] User accounts: Username, password, expiry date, max connections, bouquet assignments
[ ] Reseller accounts: Credentials, credit balance, pricing configuration
[ ] Stream URLs: All live stream source URLs and configurations
[ ] VOD content: Movie/series URLs, metadata, poster images
[ ] Categories: Category names and ordering
[ ] Bouquet definitions: Which streams are in which bouquet
[ ] EPG sources: EPG XML URLs and channel mappings
[ ] Server configuration: Port numbers, SSL certificates, DNS records

Export Methods

Method 1: Database Export The most reliable method. Access your Xtream UI MySQL database:

-- Export user accounts
SELECT username, password, exp_date, max_connections, bouquet
FROM users;
-- Export reseller accounts SELECT username, password, credits, notes FROM reg_users WHERE member_group_id > 1;
-- Export streams SELECT stream_display_name, stream_source, category_id, stream_type FROM streams;

Method 2: PHP Export Script If you prefer not to work with raw SQL, create a PHP script that exports data to JSON format. Place it in your Xtream UI web directory and run it via browser or CLI. Method 3: Billing Platform Migration Tool If you're using a billing platform like IPTVbp, it includes a WHMCS/panel migration tool that can extract customer data from your existing setup and re-import it into the new panel automatically.

Step 1: Set Up Your New XUI One Server

Server Preparation

Ideally, install XUI One on a new, separate server. This allows you to:

Configure everything without affecting your live service
Test thoroughly before switching customers over
Keep Xtream UI running as a fallback during migration

Follow our XUI One setup guide for detailed installation instructions.

Recommended Hardware

For the new server, match or exceed your current specifications:

Same or better CPU/RAM
SSD storage (significantly better than HDD for panel operations)
Same or better bandwidth
Geographic location close to your customer base

Step 2: Configure XUI One

Recreate Your Structure

In XUI One, set up your content structure to match (or improve upon) your Xtream UI setup: Categories: Create the same category structure. You can take this opportunity to reorganize categories for a better customer experience. Bouquets: Recreate your bouquets with the same channel groupings. Consider whether your current bouquet structure is optimal — migration is a good time to restructure packages. EPG Sources: Add the same EPG sources. XUI One's EPG handling is generally more reliable, so you might find that channels that had EPG issues on Xtream UI work better now.

Add Streams

Import your stream sources into XUI One:

Add streams individually through the admin panel
Or use the bulk import feature with your exported stream list

Important: Test each stream source after adding. Some sources that worked on Xtream UI might need different settings on XUI One (different user agents, specific output formats, etc.).

Step 3: Import Customer Accounts

User Account Migration

This is the most critical step. You need to import all customer accounts with their existing credentials so they can continue using the same login details. Option A: Manual Import via Admin Panel For small operations (under 100 users), you can create accounts manually. Tedious but straightforward. Option B: Bulk Import via API Use the XUI One API to automate account creation. Write a script that:

Reads your exported user data
Creates each account via the XUI One API
Assigns the correct bouquet(s)
Sets the correct expiry date
Maintains the same username and password

Option C: Database Import For large migrations, direct database manipulation is fastest but riskiest. Only use this if you're comfortable with MySQL and understand XUI One's database schema. Option D: Billing Platform Migration If you're connecting a billing platform, it can handle the import:

Import customers from your Xtream UI database export or CSV
The billing platform creates accounts in XUI One via API
Customers are automatically set up with correct packages and expiry dates
Billing records are created for future renewal tracking

Preserving Customer Credentials

The key to a seamless migration is keeping the same credentials:

Username/password accounts: Import with identical credentials. Customers won't notice the backend change.
MAC address accounts: Import with the same MAC addresses. The MAG/Formuler devices will continue working with the new server URL.

Step 4: Import Reseller Accounts

Reseller migration requires:

Create reseller accounts with matching credentials
Assign the correct credit balance
Map their customers to the reseller account
Verify bouquet access matches their previous configuration

Important: Notify your resellers before the migration. They need to update their panel access URL and may need to re-configure their reseller tools.

Step 5: DNS and Network Transition

The DNS Switch Strategy

The cleanest migration approach uses DNS:

Before migration: Your DNS (e.g., panel.yourdomain.com) points to the Xtream UI server
During testing: Access XUI One directly by IP while Xtream UI continues serving customers
Migration moment: Update DNS to point to the XUI One server
TTL planning: Lower your DNS TTL to 300 seconds (5 minutes) at least 24 hours before migration. This ensures the switch propagates quickly.

Port Considerations

Xtream UI and XUI One use different default ports. To avoid customer disruption:

Configure XUI One to use the same ports your customers currently connect on
Or use a reverse proxy (Nginx) to handle port mapping
Update your DNS SRV records if applicable

SSL Certificates

If you're using SSL (and you should be):

Install the same SSL certificate on the new server
Or generate a new Let's Encrypt certificate
Test HTTPS connectivity before switching DNS

Step 6: Testing Phase

Pre-Switch Testing (On New Server)

Test using direct IP access while Xtream UI is still live:

Admin panel access: Log in, navigate all sections, verify everything looks correct
Stream playback: Test 10-20 channels across different categories and bouquets
EPG display: Verify program guide loads correctly
VOD playback: Test movie and series playback
User authentication: Log in with migrated customer credentials
Multi-connection limits: Verify connection limits work correctly
Reseller panel: Have a reseller test their access and credit operations
API connectivity: If using billing automation, verify API calls work

Parallel Running (Optional but Recommended)

For high-value operations, run both panels simultaneously for 24-48 hours:

New connections go to XUI One
Existing connections continue on Xtream UI
Monitor both for issues
Fully switch when confident

Step 7: Execute the Migration

Migration Day Checklist

Before the switch:

[ ] Final data export from Xtream UI (catch any last-minute changes)
[ ] Import any new users created since last export
[ ] Verify all streams are working on XUI One
[ ] Confirm DNS TTL is low (300 seconds)
[ ] Notify resellers of the scheduled switch time
[ ] Prepare rollback plan (DNS back to old server)

During the switch:

[ ] Update DNS records to point to XUI One server
[ ] Monitor DNS propagation (use online tools)
[ ] Watch XUI One logs for incoming connections
[ ] Test from multiple locations and devices
[ ] Monitor server resources (CPU, RAM, bandwidth)

After the switch:

[ ] Verify customer connections are working
[ ] Check that resellers can access their panel
[ ] Confirm billing platform API is working with the new panel
[ ] Monitor for 24 hours before considering migration complete

Handling the Transition Period

During DNS propagation (up to 48 hours for full global propagation):

Some customers may still hit the old Xtream UI server
Keep Xtream UI running during this period
Monitor both servers for connection issues
Be prepared to answer support queries about any brief disruptions

Step 8: Post-Migration Optimization

Performance Tuning

Now that you're on XUI One, optimize for performance:

Configure connection pooling
Set up monitoring dashboards
Enable caching for EPG and VOD metadata
Optimize database settings for your workload

Connect Billing Automation

With XUI One's superior API, now is the perfect time to connect automated billing:

Automatic provisioning on payment
Subscription renewal automation
Customer self-service portal
Reseller credit auto-top-up

Clean Up

After confirming everything works (wait at least 1 week):

Decommission the old Xtream UI server
Update all documentation and URLs
Remove old DNS records
Cancel old server if it was a separate machine

Rollback Plan

Always have a rollback plan:

DNS rollback: Switch DNS back to Xtream UI server (propagates within your TTL setting)
Data sync: Any new accounts created on XUI One during the attempted migration need to be created on Xtream UI too
Communication: Have a template message ready for resellers/customers explaining the delay

The beauty of the DNS switch approach is that rollback is fast and low-risk.

Common Migration Pitfalls

Forgetting to export EPG mappings: You'll need to redo EPG-to-channel mapping on XUI One. This can take hours for large channel lists. Different password hashing: If Xtream UI and XUI One use different password hashing methods, credentials won't work. Check compatibility beforehand. Port conflicts: Make sure XUI One's ports don't conflict with any existing services on the new server. Timezone mismatches: Ensure both servers use the same timezone, or expiry dates will be off. Missing stream sources: Some stream providers whitelist by IP. You'll need to add the new server's IP to their whitelist before migration.

Explore more guides to help you grow your IPTV business:

FAQ

Q: How long does the full migration take? A: For a typical operation (500-2,000 customers), plan for 1-2 days of preparation, a few hours for the actual switch, and 1 week of monitoring. The actual customer-facing downtime should be under 30 minutes. Q: Will my customers need to change anything? A: If you use DNS and keep the same ports and credentials, most customers won't need to change anything. Their apps will automatically connect to the new server. MAC-based devices may need a portal URL update. Q: Can I migrate only some customers first? A: Yes. You can do a phased migration by creating only specific customer accounts on XUI One first, testing with them, then migrating the rest. Q: What if a stream source doesn't work on XUI One? A: Most stream sources work identically. If one doesn't, try changing the user agent string, output format, or proxy settings in XUI One's stream configuration. Q: Should I migrate during peak or off-peak hours? A: Always migrate during your lowest-traffic period. For most IPTV providers, this is late morning on a weekday (no prime-time TV, no weekend sports). Q: Do I need to buy a new XUI One license for migration? A: Yes, you'll need a valid XUI One license. Factor this into your migration budget. The improved performance and automation capabilities justify the investment quickly.

How to Migrate from Xtream UI to XUI One Without Losing Customers