Knowledgebase

Overview

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 public_html (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:

1. Enter the domain for the new addon domain in the New Domain Namefield.
   • 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 .com, .net, etc.), be sure to manually enter a unique username into the Subdomain/FTP Username field.
2. Enter the directory that will contain the addon domain’s files in the Document Root field.
3. Enter the password for the addon domain into the Passwordfield.
   • Make sure you use a secure password.
   • You can have cPanel generate a secure pasword for you using the Generate Password feature.
4. Confirm the password in the Password (Again) field.
5. 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.
6. To add files to the addon domain’s home directory, click the File Managerlink.
   • Note: To access this addon domain’s home directory in the File Manager, click the link under Document Root.

Note: 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:

1. Click the notepad icon corresponding to the addon domain that you wish to manage.
2. Enter the new file path that you would like to use as the document root in the available text box.
3. Click Change.

Enable or disable addon domain redirection

To disable or enable redirection of an addon domain:

1. Click the Manage Redirection link which corresponds to the addon domain that you wish to manage.
2. If you wish to redirect the domain, enter the link that you wish to redirect the addon domain to in the available text box.
3. Click Save.
   • To disable the redirect, click Disable Redirection.

Remove an addon domain

To remove an existing addon domain:

1. Click the Remove link which corresponds to the addon domain that you would like to remove.
2. to confirm that you wish to remove the addon domain, click Yes.
3. 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: home/username/mail.

• 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

Search Addon Domains

To search the list of addon domains:

1. Enter the search criteria into the Search box.
2. Click Go.

Results which match your search criteria will populate the list.

Addon vs. Parked Domains