How to migrate from cPanel/WHM: accounts, email and databases
On this page
You can move accounts from a cPanel/WHM server in two ways: with the Transfer Tool (root SSH access to the WHM server) or by importing cpmove backup files. The cPanel server is not changed.
Option 1: Transfer Tool (recommended)
- Open Transfer Tool in the administrator panel (section Move to this server).
- Connect with the WHM server's IP, SSH port and root password or SSH key, and click Connect & list accounts. The tool recognises cPanel and lists its accounts with their domain, plan, disk use and suspension.
- Tick the accounts, choose the options and click Transfer selected accounts.
For each account, the tool runs cPanel's own /scripts/pkgacct on the old server at the lowest CPU and disk priority (without bandwidth data), copies the cpmove archive here, deletes it on the old server and imports it. Full steps: transfer accounts with the Transfer Tool.
Option 2: Import a cpmove file
Make a full backup on the cPanel server, then upload it under Import a Backup:
- As root:
/scripts/pkgacct USERNAMEcreates/home/cpmove-USERNAME.tar.gz. - As the cPanel user: Files → Backup → Download a Full Account Backup.
See import a backup file.
What comes over from cPanel
- The main domain, addon domains, subdomains and parked domains (aliases), with their document roots.
- Website files of the home folder (not cPanel's own folders such as
.cpaneland.trash). - Mailboxes with their mail, quota and password; forwarders.
- MySQL databases and users with their passwords and privileges.
- DNS zones (A records pointed here if you choose), cron jobs.
- FTP accounts with their passwords, and each domain's DKIM key, so mail stays signed with the key already published in DNS.
- The account password, when cPanel stored it as a SHA-512 hash (the usual case).
Good to know
- Usernames on this server have up to 16 lowercase letters and digits and start with a letter. cPanel accounts whose name does not fit are not listed by the Transfer Tool.
- Databases must carry the account prefix (
user_). A database without it is skipped with a warning. - Mailboxes with an old password format get a new password, listed once on the account's migration page.
- Forwarders to pipes,
:fail:and local aliases are skipped. - Accounts suspended on cPanel stay suspended here.
- Plan names are matched to packages of the same name; create them first.
Common questions
Does the Transfer Tool need WHM API access?
It uses SSH as root and runs cPanel's own tools there (whmapi1 to list accounts, pkgacct to package them). No API token is needed.
Can I migrate a single cPanel account without root?
Yes. The account owner downloads a full account backup in cPanel, and you import that file.
Thank you — this helps us improve the article.
Still stuck?
Ask the AI about your exact situation — it answers from this knowledge base — or contact us.
Related articles
- How to transfer accounts from another server (Transfer Tool)
Connect to a cPanel/WHM, Plesk or DirectAdmin server over SSH, pick the accounts, and copy websites, email, databases, DNS and cron jobs here.
- How to import a cPanel or DirectAdmin backup file
Upload a cpmove or DirectAdmin user backup (or copy a large one to /backup/import), review what is inside and import it as a new account.
- What is copied in a migration, and what is not
The full list of what a transfer or backup import copies — websites, email, databases, DNS, cron, passwords — and what you must set up again.
- How to run the final sync before switching DNS
Copy only what changed on the old server since the transfer — new files, new email and fresh databases — just before you point the domains here.