How to add a new website as an Addon domain

There are a number of ways to add a new domain or site to your account. We have a separate guide that details the differences.

This guide covers how to add an Addon domain.

cPanel > DOMAINS > Addon Domain

If you'd like to add a new domain, on which you'd like to run a new website you'll need to add it as an Addon domain.

Addon domains count towards your number of unique websites. Addon domains can have their own unique email accounts.

The Amethyst package allows up to two domains (primary plus one addon) and Topaz allows up to ten (primary plus nine addons). Ruby Cloud hosting and all Premium/Business packages allow unlimited Addon domains. These are all single cPanel plans - so all sites share the resources of the individual cPanel.

To add an Addon domain, click the Addon Domains icon within the DOMAINS section in cPanel.

New Domain Name - Enter the new Addon domain here (don't include the www - the system will automatically work with www as well once you're finished).

Subdomain/FTP Username - cPanel creates a subdomain and an FTP account for the Addon domain. The example shown would create a subdomain called myaddondomain.myprimarydomain - this is primarily to allow the statistics software to function correctly. An FTP account will also be created (if you tick the Create an FTP account... tick box) with a login username of e.g. ftp-username@my.addon.domain and a password matching the one you set in the Password fields.

Document Root - This is where you want to keep the files for your addon website. This is normally a subdirectory of your public_html/ directory, and by default it uses the domain name you are adding as the name of that directory, e.g. public_html/addondomain.co.uk - however, you can chose any directory name you like.  If you are going to host several websites, then it is a good idea to place the domain's document root at the top level, so instead of the Document Root saying public_html/domain2.com it would simply say domain2.com. This avoids a number of problems that can arise from the use of mod_rewrite in your primary domain.

Click the Add Domain button to finish adding your Addon domain.

In the above examples then either /public_html/myaddondomain.co.uk/myfile.html (document root as sub-domain under public_html) or /myaddondomain.co.uk/myfile.html (document root at top level) would be served to the world as http://myaddondomain.co.uk/myfile.html

If you are adding a handful of domains with the same basic name (e.g. domain2.com, domain2.co.uk, domain2.org etc) then you might get a message saying that the Subdomain or FTP User already exists. This is because cPanel will, by default, try to use the first part of the domain name for the Subdomain/FTP username, so you will have to change the default to something else for each of your domains.

Ensure you upload your website files to the correct Document Root folder.

Email and Addon Domains

Addon domains are treated separately in terms of email handling - i.e. you can maintain mailboxes for all of your domains entirely independently.

Errors when adding an alias or addon domain

When adding a domain name which is already assigned to another Krystal cPanel account on another server, you will see this message.

When adding a domain name which is already assigned to this or another Krystal cPanel account on this server, you will see this message.

In the case above, the domain krystaldemo.co.uk cannot be added because it is already associated with another user.

You will be unable to add an Alias or Addon domain if it is already either

  • A primary domain for another Krystal cPanel account
  • An Alias or Addon domain on another Krystal cPanel account - even the same one you are working with.

If you need help figuring out where the domain has been duplicated, please raise a support ticket from your Krystal Client Area.


How did we do?


Powered by HelpDocs
© Krystal Hosting Ltd 2003–2019