How to migrate from cPanel/WHM: accounts, email and databases

For server administrators · Updated 2026-10-29

On this page
  1. Option 1: Transfer Tool (recommended)
  2. Option 2: Import a cpmove file
  3. What comes over from cPanel
  4. Good to know
  5. Common questions

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.

  1. Open Transfer Tool in the administrator panel (section Move to this server).
  2. 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.
  3. 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 USERNAME creates /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 .cpanel and .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.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.