How to Restore a cPanel Full Backup to a Dedicated Server (WHM & SSH Guide)

Introduction

Migrating your website to a more powerful environment is a common step as your business grows. Whether you're moving from shared hosting or another server, restoring a cPanel full backup to a dedicated server ensures all your files, databases, email accounts, and settings transfer reliably.

cPanel and WHM provide user-friendly tools for this process, while experienced administrators often prefer the speed and control of SSH and command-line methods. This comprehensive guide walks you through both approaches, so you can choose the one that best fits your comfort level.

At Leo Servers, we specialize in helping clients complete seamless website migrations to high-performance infrastructure. If you're ready for better speed, resources, and reliability, consider upgrading to a high-performance dedicated server.

What You'll Learn

Prerequisites

Before starting the restoration, ensure you have the following:

Method 1: Restoring via WHM (Graphical Interface)

This method is ideal for users who prefer a visual interface and is the most straightforward for most webmasters.

1. Upload or Place the Backup File

Log in to your new server via WHM (usually https://your-server-ip:2087). Use WHM's File Manager or SSH/SCP to place the full backup (cpmove or .tar.gz) in the /home directory.

2. Access the Restore Interface

In WHM, search for "Transfer or Restore a cPanel Account" or navigate to:
Home → Transfers → Transfer or Restore a cPanel Account.

3. Select Restore Option

Choose Restore from a local cpmove file.
In the Select a File menu, browse or enter the name of your backup file located in /home.

4. Configure Restore Options

• Check Overwrite if the cPanel user already exists (if applicable).
• Under A records, select:
  • Replace All Matching A Records (recommended for full migration), or
  • Replace only basic cPanel-provided A records.
• Review any other available options based on your WHM version.

5. Start the Restoration

Click Restore. Monitor progress in the Account Restore interface. The process can take several minutes to hours depending on the size of your site.

WHM will handle account creation, file restoration, database import, and permission settings automatically.

Method 2: Restoring via SSH (Command Line)

For faster restoration or when managing multiple accounts, the command-line method using the restorepkg script is powerful.

1. Access the Server via SSH

Connect as the root user using your preferred terminal or SSH client.

2. Place the Backup File

Ensure your cpmove-username.tar.gz or full backup .tar.gz file is in the /home directory:

mv /path/to/your-backup.tar.gz /home/

3. Restore Using the Script

Run one of the following commands:

By username (if the backup follows standard naming):

/scripts/restorepkg username

By full path to the backup file (more reliable):

/scripts/restorepkg /home/cpmove-username.tar.gz

Or for a generic backup name:

/scripts/restorepkg /home/backup-date_username.tar.gz

4. Monitor the Process

The script will output progress in real-time. You can also check logs later in WHM under Transfers → Review Transfers and Restores.

This method is efficient on dedicated servers where you have full root access and want minimal overhead.

Post-Restoration Checklist

After the restore completes, verify everything works correctly:

• Login to cPanel — Confirm you can access the restored account.
• Website Functionality — Browse your site and test key pages, forms, and dynamic content.
• Databases — Check phpMyAdmin or MySQL for imported databases and update any hard-coded connections if needed.
• Email Accounts — Test sending and receiving emails.
• Permissions — Ensure files and folders have correct permissions (typically 644 for files, 755 for directories).
• DNS/IP Updates — Update your domain's A record to point to the new server's IP.
• SSL Certificates — Reinstall or reissue SSLs if they don't auto-renew.
• Cron Jobs & Custom Settings — Verify any scheduled tasks or custom configurations.
• Clear Caches — Clear any website, opcode, or CDN caches.

Run a full site audit and monitor error logs (/usr/local/cpanel/logs and your application's logs) for the first 24–48 hours.

Troubleshooting Tips

• "File not found" or backup not detected — Ensure the file is in /home and has not been renamed. Standard names like cpmove-username.tar.gz work best.
• Permission or ownership errors — The restore process usually fixes these, but you can manually correct with:
  BASH Copy

  chown -R username:username /home/username
  chmod -R 755 /home/username/public_html

• Database connection issues — Update wp-config.php or equivalent files with the new database credentials if they differ.
• Partial restore or stalled process — Check disk space and server resources. On dedicated servers, this is rarely an issue, but large sites may need increased PHP/memory limits temporarily.
• IP-related problems — Use the "Replace All Matching A Records" option during WHM restore.
• Large backup hangs — Consider restoring via SSH in a screen or tmux session to prevent disconnection.

If issues persist, review restoration logs in WHM or contact your server provider's support with specific error messages.

Conclusion

Restoring a cPanel full backup to a dedicated server is a reliable way to complete a website migration with minimal downtime. Whether you use the intuitive WHM graphical interface or the efficient SSH command-line approach with restorepkg, following these steps ensures your files, databases, and configurations transfer successfully.

A smooth migration sets the foundation for better performance and scalability. Once restored, enjoy the power and control that comes with dedicated resources.

Need a robust, high-performance dedicated server for your growing website? Explore Leo Servers' offerings and get expert assistance with your migration.

Have questions about this process or need help with a specific step? Feel free to leave a comment below — we're here to help webmasters and developers succeed.