Migration Guide
MigrateAssist – import from WHMCS, Blesta, HostBill, ClientExec
What it is
MigrateAssist is WHMDC's migration tool for importing data from WHMCS 8+, Blesta, HostBill, or ClientExec. It imports clients, products, services, invoices, transactions, domains, support tickets, and related data into a fresh or existing WHMDC installation.
How it works
MigrateAssist connects to the source system's database (read-only recommended), validates schema compatibility, maps tables and columns, and performs the import. Passwords are hashed in the source system; WHMDC stores them as-is where compatible, but clients may need to use "Forgot password" to reset if hashing differs.
What is imported:
- Clients (users, client records, addresses)
- Products and product pricing
- Services (with status, billing cycle, next due date)
- Invoices and invoice items
- Transactions (payment history)
- Domains
- Support tickets and replies
How to set up
- Backup both databases before starting.
- Install WHMDC on your target server (or use existing installation).
- Run MigrateAssist from Admin (or the migration tool in the install directory).
- Enter source database details: host, database name, username, password. Use a read-only user if possible.
- Validate connection and run the compatibility check.
- Run the import. This may take several minutes for large datasets.
- Verify data in Admin: clients, products, services, invoices.
- Advise clients to reset passwords if they cannot log in.
Important limitations
- WHMCS, Blesta, HostBill, ClientExec add-ons do not run on WHMDC. Third-party modules, hooks, and customisations from WHMCS, Blesta, HostBill, ClientExec will not be migrated. Use the WHMDC API, webhooks, or custom addons for equivalent functionality.
- Server provisioning: Services will have the correct product and client assignment, but you may need to re-provision hosting accounts on your servers or use WHMDC server modules.
- Payment gateways: Configure Stripe, PayPal, etc. in WHMDC separately. Transaction history is imported for reference.
Related
See Troubleshooting for migration errors, and API Reference for integration options.
Was this helpful?