To transfer or restore a cPanel account, use the WHM Transfer or Restore interface to migrate accounts between servers or restore from backup files. You'll need an archive file (cpmove or backup format) stored in specific server directories, and your server must have at least double the archive file size available in disk space for successful extraction.
Understanding cPanel Account Transfer and Restoration
The Transfer or Restore a cPanel Account interface in WHM allows server administrators to move cPanel accounts between servers or restore them from archive files. This process is essential when migrating hosting accounts or recovering from backups.
An archive file can be either a standard cPanel backup file or a cpmove file, which is the specialized format cPanel uses for account migrations. Both formats contain all the necessary data to recreate a hosting account on a new server.
Important Requirements Before Starting
Before you begin transferring or restoring a cPanel account, ensure your server meets these critical requirements:
- Disk Space: Your server must have at least double the archive file's size available in free disk space. The system needs this extra space to extract and process the files during restoration.
- Root Access: If you have root access to both source and destination servers, consider using WHM's Transfer Tool interface instead. This tool provides a more streamlined migration process and should be your first choice when available.
- MySQL Configuration: Never use the skip-name-resolve setting in your MySQL configuration. This setting causes serious operational issues, including failed transfers, restoration problems, and phpMyAdmin errors.
- Two-Factor Authentication: Note that 2FA configuration does not transfer with the account. Users will need to reconfigure their two-factor authentication on the new server.
Archive File Naming Requirements
For successful transfer or restoration, your archive file must use one of these specific naming formats:
- cpmove-{USER}
- cpmove-{USER}.tar
- cpmove-{USER}.tar.gz
- {USER}.tar
- {USER}.tar.gz
- backup-{MM.DD.YYYY}{HH-MM-SS}{USER}.tar
- backup-{MM.DD.YYYY}{HH-MM-SS}{USER}.tar.gz
- backup-{MM.DD.YYYY}_{HH-MM-SS}_{USER}.tar
- backup-{MM.DD.YYYY}_{HH-MM-SS}_{USER}.tar.gz
In these formats, {USER} represents the cPanel username, and the date/time stamps follow the month.day.year and hour-minute-second format when applicable.
Required File Locations
The archive file must be located in one of these approved server directories:
- /home
- /home2
- /home3
- /root
- /usr
- /usr/home
- /web
Files located outside these directories will not be recognized by the transfer interface. If your backup is stored elsewhere, move it to one of these locations before attempting the restoration.
Best Practices for Account Transfers
Follow these best practices to ensure smooth account transfers and restorations:
- Verify File Integrity: Before starting the transfer, confirm your archive file is not corrupted and contains all necessary account data.
- Check Server Resources: Monitor available disk space, CPU usage, and memory before beginning large transfers.
- Plan for Downtime: Schedule transfers during low-traffic periods to minimize impact on users.
- Use Transfer Tool When Possible: If you have root access to both servers, the WHM Transfer Tool provides better error handling and progress tracking than manual restoration.
- Document the Process: Keep records of transfer dates, file names, and any issues encountered for future reference.
Troubleshooting Common Transfer Issues
If you encounter problems during account transfer or restoration, check these common issues:
Insufficient Disk Space: The most frequent cause of failed transfers is inadequate disk space. Remember, you need at least twice the archive file size available.
File Naming Errors: Ensure your archive file follows one of the accepted naming conventions exactly. Even small deviations will cause the system to reject the file.
Incorrect File Location: Verify the archive is stored in an approved directory. The system will not search outside these specific paths.
MySQL Issues: If you're experiencing database problems after restoration, confirm that skip-name-resolve is not enabled in your MySQL configuration.
Frequently Asked Questions
What file format should I use for transferring a cPanel account?
Use either the cpmove format (cpmove-username.tar.gz) or standard backup format (backup-date-time-username.tar.gz). Both formats are fully supported. The cpmove format is specifically designed for account migrations, while backup files can be generated through WHM's backup system.
Why does my account transfer need so much disk space?
The system requires double the archive file size because it needs to store both the compressed archive and the extracted files simultaneously during the restoration process. After extraction completes, the temporary files are removed, but both versions exist during the transfer.
Will my users' passwords transfer with the account?
Yes, user passwords for cPanel, email accounts, and databases transfer with the account. However, two-factor authentication settings do not transfer and must be reconfigured on the new server.
Can I transfer an account between servers with different cPanel versions?
While transfers between different cPanel versions are possible, it's best practice to ensure both servers run similar versions. Transferring from newer to older versions may cause compatibility issues with certain features. OBHost maintains current cPanel versions on all servers to ensure smooth migrations.
If you need assistance with transferring or restoring a cPanel account, our support team is available 24/7 to help. Visit our contact page or email support@obhost.org for expert guidance with your account migration needs.
