- This document is only valid for cPanel & WHM version 54 and earlier.
- cPanel Technical Support does not provide assistance with the instructions in this article.
- In cPanel & WHM version 56 and later, use WHM's Convert Addon Domain to Account interface ( WHM >> Home >> Transfers >> Convert Addon Domain to Account ).
- Because it requires that you move files, only the
rootuser or resellers with
root-level privileges can perform this action.
After you create an addon domain, you can create an entirely new account from that addon domain. To do this, copy the information from the addon domain and add it to a newly-created account. This tutorial shows you how to copy addon domains to a new account.
This document uses the following example values:
usernamerepresents the user of the account.
newusernamerepresents the user of the new account.
addonnamerepresents the name of the addon domain.
addondirectoryrepresents the directory for the addon domain.
Copy addon domains to a new account
Create a backup file.
Perform a full backup of the account that contains the addon domain. To do this, use cPanel's Backups interface (cPanel >> Home >> Files >> Backups) or run the
For more information about the contents of the backup file, read our Backup Tarball Contents documentation.
Create a new account.
Create a new account with a placeholder name in WHM's Create a New Account interface (WHM >> Home >> Account Functions >> Create a New Account).
Do not use the addon domain's name as the new account name.
Extract the backup file.
To extract the backup file, perform the following steps:
Run the following commands to create the
/home/backup-usernamedirectory and move the backup file into it:
Run the following commands to navigate to the
/home/backup-usernamedirectory and uncompress the backup:
These commands extract the backup file's contents to either the
Run the following command to add the
homedir/public_html/addondirectory/subdirectory to the
Import the databases.
Perform the following steps to import the databases:
Recreate the addon domain's databases and create the database users in cPanel's MySQL Databases interface (cPanel >> Home >> Databases >> MySQL Databases).
newusernameto the databases when you create them. For example, you might create the
dbnamerepresents the name of the database.
After you create the databases and database users, import each domain's database backups. To do this, run the following command for each backup:
Update cron job paths.
Perform the following steps to update the cron paths for the new account:
- Open the
/home/backup-username/username/cron/usernamefile and check for the addon domain's cron jobs.
Add the paths for the addon domain's cron jobs to the new account in cPanel's Cron Jobs interface (cPanel >> Home >> Advanced >> Cron Jobs).
Ensure that the cron jobs' paths match the new account's paths to the same cron jobs files.
Change file ownership.
chown command to grant ownership of the copied
public_html files to the
Confirm that the account functions
After you change the files' ownership, confirm that the account functions correctly. To do this, point your operating system's
hosts file to the temporary domain placeholder.
For information about how to set the
hosts file for your operating system, read Wikipedia's hosts file article.
Change the placeholder domain's name.
Navigate to WHM's Modify an Account interface (WHM >> Home >> Accounts >> Modify an Account) and change the new account's main domain name to the addon domain's name.
Copy over email account information
Change the domain name, copy the old account's emails, forwarders, filters, and autoresponders to the new account. To do this, open the
/home/backup-username/username directory and run the following commands:
After you copy the emails, forwarders, filters and autoresponders, change the ownership of those files to the new user. To do this, run the following commands:
Make certain that you append asterisks (
* ) on either side of
addonname to ensure that it keeps the wildcards.
After you change the ownership of the files, confirm that you can log in to the user's Webmail account.
Navigate to the
/home/newusername/etc/addonname directory to find the users and email passwords for authentication to IMAP, POP3, and Webmail.