How to import a cPanel or DirectAdmin backup file

For server administrators · Updated 2026-10-29

On this page
  1. Supported archives
  2. Step 1: Get the archive onto this server
  3. Step 2: Review
  4. Step 3: Import
  5. Good to know
  6. Common questions

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

SourceFile
cPanelcpmove-USER.tar.gz (from pkgacct or a full account backup)
DirectAdminuser.RESELLER.USER.tar.gz or .tar.zst
This control panelA 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

  1. Log in to the administrator panel (https://<server>:2087).
  2. Open Import a Backup in the menu (section Move to this server).
  3. 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/import on 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

  1. 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.
  2. Under What to import, tick Website files, Email accounts & mail, MySQL databases, DNS zones and/or Cron jobs.
  3. Leave Point A records from the old IP (…) to this server (…) ticked to point the imported DNS records here.
  4. 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/import until 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.

Was this article helpful?

Still stuck?

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