How to migrate PBX to Cloud

How to migrate PBX to Cloud

The document describes how to migrate PBX to Cloud.

Created: January 2026

Permalink: https://wildix.atlassian.net/wiki/x/AwAPbg

Limitations:

  • DB size for migration is limited by the root partition size on Cloud PBX: about ~6-7G

Important! After the migration to Cloud is completed, turn off or reset to default the old HW PBX to avoid routing/ network issues.

To move your PBX to Cloud, you need to create a new Cloud instance instead of your current PBX. The subscription plans active on this PBX and the PBX serial will be moved to the new Cloud instance. 

Important notes:

  • PBX will not be reachable for up to 20 minutes, during which the DNS record will be updated (the migration time depends on the migrated DB size), remember to update/remove any local DNS proxies; phones/media gateways must use the DNS name for provisioning or they will not switch automatically to the Cloud PBX

  • The old PBX will stop working as soon as the licence will be synced

How-to:

  1. Access WMP using your credentials

  2. Select your company and your customer

  3. Click Options button (Three dots) and select Edit

  4. Click Advanced features

  5. Click Migrate to new WCloud PBX

PBX-activation-migrate to Cloud.jpg

Run the script on old PBX to move all the data 

Now when you've created a new Cloud instance for your HW/ VM PBX, you need to launch the script on your old PBX that will move all the data from your old PBX to the new one.

Run the script:

  • Access WMS, Open Terminal on the PBX, select the option 10 (Shell), access as root (su - wildix)

  • Run the following command: 

    chmod +x /usr/sbin/migrate2cloud
  • Run the command: 

    migrate2cloud