For cPanel version 11.40
(Home >> Domains >> Addon Domains)
An addon domain allows a new domain name to link to a subdirectory of your account. The addon domain’s files will be stored in a subdirectory of your
(Document Root) directory. Addon domains allow you to control multiple domains from a single account. Addon domains are allowed by your web host in WHM's Tweak Settings
interface. (Home >> Server Configuration >> Tweak Settings
Create an Addon Domain
To create an addon domain:
- Enter the domain for the new addon domain in the New Domain Name field.
- Note: When you enter the domain name, cPanel automatically populates the Subdomain/FTP Username field. If you are creating multiple addons with similar domain names (differing only in
.net, etc.), be sure to manually enter a unique username into the Subdomain/FTP Username field.
- Enter the directory that will contain the addon domain’s files in the Document Root field.
- Enter the password for the addon domain into the Password field.
- Make sure you use a secure password.
- You can have cPanel generate a secure pasword for you using the Generate Password feature.
- Confirm the password in the Password (Again) field.
- Click Add Domain
- Note: When you create an addon domain in the cPanel interface, cPanel automatically creates a subdomain. If you alter or delete the subdomain after it has been created, you may affect or delete the information displayed in the addon domain's website.
- To add files to the addon domain’s home directory, click the File Manager link.
- Note: To access this addon domain’s home directory in the File Manager, click the link under Document Root.
Web statistics for the addon domain will be found under the subdomain's URL in the statistics application.
Modify Addon Domains
Modify the document root for an addon domain
To modify the document root for an addon domain:
- Click the notepad icon corresponding to the addon domain that you wish to manage.
- Enter the new file path that you would like to use as the document root in the available text box.
- Click Change.
Enable or disable addon domain redirection
To disable or enable redirection of an addon domain:
- Click the Manage Redirection link which corresponds to the addon domain that you wish to manage.
- If you wish to redirect the domain, enter the link that you wish to redirect the addon domain to in the available text box.
- Click Save.
- To disable the redirect, click Disable Redirection.
Remove an addon domain
To remove an existing addon domain:
- Click the Remove link which corresponds to the addon domain that you would like to remove.
- to confirm that you wish to remove the addon domain, click Yes.
- To keep the addon domain, click No.
Email Accounts in Addon Domains
Email accounts can be created for addon domains. Read the Email Accounts
documentation to learn how to set up an email account for an addon domain.
When you remove the addon domain, email accounts that are associated with the addon domain will no longer appear in the cPanel interface. However, the contents for this email account still exist in the mail folder of the user's home directory:
- If the domain is added back to the same account as the primary domain, an addon domain, or a parked domain, the email accounts will reappear in the cPanel interface.
- If the domain is moved to a different account, the email accounts will need to be added to the new account manually, and the contents of the email account will also need to be moved manually. The email accounts will need to follow the same format that they previously had: same name and same domain.
- You can use the cPanel interface to add new accounts, or you can run the
/scripts/addpop script to manually add new email accounts.
- To move one email account under a domain, you can run:
mv /home/old_account/mail/domain_name/email_account /home/new_account/mail/domain_name/ When you run this command, the
/home/new_account/mail/domain_name/ directory will be created when you add the account through cPanel.
- To move all the email accounts under a domain, run:
mv /home/old_account/mail/domain_name /home/new_account/mail After the files have been moved, run:
chown -R new_account:new_account /home/new_account/mail/domain_name
You should verify ownership of the email account after you have moved it.
Search Addon Domains
To search the list of addon domains:
- Enter the search criteria into the Search box.
- Click Go.
Results which match your search criteria will populate the list.
Addon vs. Parked Domains
|| Addon Domains
|| Parked Domains
| Main domain appears in the address bar
| Apache directive used
| Separate logs
| Separate stats
| Treated as a subdomain (other than URL)
| Ideal for multiple domains that share the same address
Additional information about Addon Domains
When you remove an addon domain, any email accounts associated with that domain will no longer appear in the cPanel interface. However, the files for these email accounts will still exist. If you re-add the same addon domain, any email accounts associated with that domain will appear in the cPanel interface.
The email accounts will also appear in the cPanel interface if you change the account’s primary domain name to the removed addon domain name. You can perform this action in WHM’s Modify an Account feature
. When you perform this action, the former primary domain name’s mailboxes will not appear in the cPanel interface. However, the files will still exist.