Migration Guide

Switch to CASTOVIA
Without Downtime

Step-by-step migration from Xtream Codes, XUI.ONE, Ministra, or any IPTV panel. Keep your subscribers, streams, and devices — upgrade everything else.

Before vs After

What changes when you switch from a self-hosted panel to CASTOVIA.

Before

Manual SSH updates, patching, PHP version management, MySQL tuning

After (CASTOVIA)

Zero maintenance — CASTOVIA is fully managed SaaS

Before

Manual firewall rules, SSL certificates, vulnerability patches

After (CASTOVIA)

Automatic token auth, GeoIP, DDoS protection, connection limits

Before

Know box model, firmware, configure each device type differently

After (CASTOVIA)

Just enter MAC → assign to line → done. No model knowledge needed

Before

Install OS, configure nginx, PHP, MySQL, panel software manually

After (CASTOVIA)

One command: curl ... | bash — agent installs in 60 seconds

Before

Buy bigger server, migrate database, hope nothing breaks

After (CASTOVIA)

Add edge nodes with one command, CDN integration, auto-scaling

Before

Build from scratch or buy expensive white-label app ($2,000+)

After (CASTOVIA)

Built-in App Builder — brand your app, submit to stores

Migration in 6 Steps

Total estimated time: ~15 minutes for a typical setup with under 1,000 streams.

1

Export Your Data

5 min

From your current panel, export your stream list (M3U or CSV), user/subscriber list (CSV), and device/MAC list (CSV). Most panels including Xtream Codes and XUI.ONE support bulk export.

  • Export streams as M3U playlist or CSV with URLs
  • Export users with usernames, passwords, expiry dates
  • Export MACs with assigned usernames/packages
2

Sign Up for CASTOVIA

1 min

Create your CASTOVIA account and choose a plan. All plans include a pilot period so you can test the full migration before committing.

  • Start with your current subscriber count as baseline
  • All features available during pilot — no restrictions
  • Keep your old panel running in parallel during transition
3

Import Streams

2 min

Go to Admin → Config → Import and upload your M3U or CSV file. CASTOVIA auto-detects stream URLs, names, categories, and logos. Review and confirm.

  • Supports M3U, CSV, and XMLTV for EPG data
  • Auto-maps categories and creates bouquets
  • Stream health check runs automatically after import
4

Import Users & Devices

3 min

Upload your subscriber list (CSV). CASTOVIA creates user accounts with matching credentials so existing apps/devices continue working. Then import MACs to connect devices to subscriptions.

  • Xtream Codes compatible API — existing apps keep working
  • Subscriber credentials preserved (username/password)
  • MAC-to-subscription assignment automatic if MACs were in export
5

Install Server Agent

1 min

Run the one-line install command on your server(s). The CASTOVIA agent connects to your control plane and your streams are ready to serve.

  • Same servers you used before — just run the agent
  • Or add new servers for edge/CDN capacity
  • Old panel can coexist on same server during transition
6

Point Domain & Go Live

2 min

Add a CNAME record for your portal domain to point to CASTOVIA. SSL is automatic. Update the portal URL on your boxes or let subscribers update theirs. That's it — you're live.

  • Add CNAME: portal.yourdomain.com → edge.castovia.com
  • SSL provisioned automatically via Let's Encrypt
  • Xtream API compatibility means apps don't need reconfiguring

Platform Compatibility

CASTOVIA supports migration from all major IPTV management systems.

Xtream Codes

Full API compatibility — existing apps work without changes

Full
XUI.ONE

Same Xtream API format — direct migration path

Full
Ministra / Stalker

Stalker portal protocol supported for MAG boxes

Full
Custom / API-based

CSV/M3U import for streams, CSV for users and MACs

Full
Flussonic

Stream URLs compatible, management via CASTOVIA after migration

Partial
Wowza

Stream ingest compatible, panel management replaced by CASTOVIA

Partial

Ready to Migrate?

Start your free pilot and run CASTOVIA alongside your current panel. Migrate at your own pace — no downtime, no data loss.