How to import a cPanel or DirectAdmin backup file
On this page
When you cannot connect to the old server, or a customer sends you their backup, import the archive in the Migration Center (menu item Import a Backup). The format is detected automatically.
Supported archives
| Source | File |
|---|---|
| cPanel | cpmove-USER.tar.gz (from pkgacct or a full account backup) |
| DirectAdmin | user.RESELLER.USER.tar.gz or .tar.zst |
| This control panel | A full backup (.tar) from another server running it |
Accepted file endings: .tar.gz, .tgz, .tar.zst and .tar. Plesk backup archives: Coming soon.
Step 1: Get the archive onto this server
- Log in to the administrator panel (
https://<server>:2087). - Open Import a Backup in the menu (section Move to this server).
- Choose one:
- Upload: under Upload a backup, choose the file and click Upload & analyze. The page shows the Upload limit.
- Larger archives: copy the file to
/backup/importon this server, for example:
scp cpmove-olduser.tar.gz [email protected]:/backup/import/
It then appears under Archives on this server. Click Analyze.
Step 2: Review
The archive is extracted and analysed. The migration page shows the Domains, Mailboxes (with forwarders), Databases (with users), the archive size and cron jobs, and whether each password is kept (password kept) or will be new (new password).
Resolve anything listed under Resolve before importing:, for example a username or domain that already exists here.
Step 3: Import
- Under Account on this server, check the Username (change it if it is taken), the Contact email and the Package. The Plan on the old server is shown.
- Under What to import, tick Website files, Email accounts & mail, MySQL databases, DNS zones and/or Cron jobs.
- Leave Point A records from the old IP (…) to this server (…) ticked to point the imported DNS records here.
- Click Start import and confirm.
The page shows Copying files, mail and databases… and refreshes by itself. When it is done, it says Imported as with a link to the new account.
Good to know
- The Migrations table on the Import a Backup page lists every import with its status. Retry reruns a failed one; Remove deletes a migration and its archive (an imported account is kept).
- An uploaded archive stays in
/backup/importuntil you click Remove. Remove it after checking the account, to free disk space. - The final sync is not available for uploaded archives. Make the backup as close as possible to the DNS switch, so few changes are left behind on the old server.
- Archives are extracted as an unprivileged user and symbolic links are checked, so a damaged or hostile archive cannot reach other files on the server.
Common questions
The upload stops or says the file is larger than the upload limit.
Copy the archive to /backup/import with scp or rsync and click Analyze under Archives on this server.
It says "Unrecognized backup".
The archive is not a cPanel, DirectAdmin or panel backup, or it is incomplete. Make a new full backup on the old server and try again.
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 migrate from cPanel/WHM: accounts, email and databases
Move cPanel accounts with the Transfer Tool or a cpmove backup file: websites, mailboxes with passwords, databases, DNS, cron jobs, FTP and DKIM keys.
- How to migrate from DirectAdmin: users, email and databases
Move DirectAdmin users with the Transfer Tool or a user backup file: domains, pointers, mailboxes, databases, DNS zones and cron jobs.
- Transfer shows "needs review": username or domain already exists
Why a transferred account waits for review, and how to fix a taken username, an existing domain or a database name before you start the import.
- After a migration: checklist for passwords, SSL, email and PHP
What to check after moving accounts: new passwords to send, warnings, SSL certificates, email records and routing, PHP versions, packages and resellers.