Easily migrate from compatible IPTV systems using the built-in XC_VM migration tool.
--- ## π Navigation * [βοΈ Before You Start](#before-you-start) * [π Migration Steps](#migration-steps) * [π Restoring Access After Migration](#restoring-access-after-migration) * [π§© Post-Migration](#post-migration) * [π₯οΈ Load Balancer Preparation](#load-balancer-preparation) --- ## βοΈ Before You Start > π‘ **Recommendation:** > Itβs best to perform migration on a **fresh XC_VM installation**. If you decide to use an **existing installation**, note the following: * XC_VM **will delete all tables** in your main database that match the data found in your migration database. * Always **create backups** before performing migration. --- ## π Migration Steps ### 1. Upload Backup Upload your existing database backup to the XC_VM server via **SFTP**. In this example, it is located at: ``` /tmp/backup.sql ``` ### 2. Restore Backup to Migration Database Use the tools script to clear the existing migration database and restore the backup: ```bash /home/xc_vm/tools migration "/tmp/backup.sql" ``` ### 3. Start Migration If the restoration completed without errors, you can start the migration using one of two methods: #### π§© Option 1 β Command Line (Recommended) Run the migration manually: ```bash /home/xc_vm/bin/php/bin/php /home/xc_vm/includes/cli/migrate.php ``` #### π Option 2 β Web Installer If you prefer not to use the command line, you can return to the **web installer** via the link provided during panel setup. Select the **βMigrationβ** option and follow the on-screen instructions to complete the process interactively. You will see real-time progress updates while XC_VM migrates your data. Once complete, you will be able to log in to your system. --- ## π Restoring Access After Migration If you cannot log in (e.g., due to missing username/password or invalid access code), you can use **rescue tools**: ### Create a Rescue Access Code ```bash /home/xc_vm/tools access ``` ### Create an Administrator to Restore Access ```bash /home/xc_vm/tools user ``` > β οΈ After logging in, immediately **change the access code and administrator credentials**. --- ## π§© Post-Migration * Load balancers will initially appear **disabled**. * All streams will **automatically stop** for safety. ### Next Steps 1. Reinstall load balancers and **manually start streams** after confirming migration. 2. Review and update **XC_VM default settings**. 3. Check main server data β domains, SSL configuration, etc. 4. Ensure everything matches your environment and settings. --- ## π₯οΈ Load Balancer Preparation You will need to reinstall the OS on the load balancers. ---