Adding subdomains

To add subdomains, your service provider must enable your site to host subdomains at the time of creating your site.

• Note: If enabled, you will find the Subdomains option listed in the shortcuts area of the Home page.

The number of subdomains you can add is set by your service provider. You can choose to be the owner of a subdomain or delegate ownership to a user of the site.

• Important: Before you assign the subdomain to a user, ensure that you have created a user for the site.    

To add a subdomain:

1. In the shortcuts area of the Home page, click Subdomains (Web Server section).

2. In the Subdomain submenu, click Add Subdomain. The Add Subdomain form opens.

3. Enter the name of the subdomain in the Name field.

4. Note: To create a subdomain sales for the site, www.example.com, enter only sales in the Name field and not sales.example.com. Note that the domain name of your site is already suffixed in the Name field.

4. In the Owner field, click the arrow to select an owner for the subdomain.

5. Note: Any existing user of the site can be authorised to be the owner of the subdomain. You can also choose to be the owner of the subdomain.

5. In the Full Directory Path field, enter the name of the subdomain directory. You will upload your subdomain content to this directory.  

• Note: The Full Directory Path is prefixed by the path, /<base_directory>/
  Where:
  <base_directory> is the directory path set by your service provider while creating the site. The default base directory is /var/www.
  
  For example, if you specify mysubdomain in the Full Directory Path field and /var/www is the base directory configured by your service provider, then your subdomain will be located at /var/www/mysubdomain.

5. Important: The subdomain directory, once defined, cannot be changed.

6. In the CGI Support field, select the checkbox if you want users to run CGI scripts on the subdomain, otherwise leave it blank.

7. Note: The CGI scripts for the subdomain will be placed in the cgi-bin directory under the subdomain folder.
   
   For example, if your subdomain is located at /var/www/<subdomain_name>, then your CGI scripts will be placed in the following location:
   /var/www/<subdomain_name>/cgi-bin/
   where <subdomain_name> is the name of your subdomain.
   
   Your subdomain can run any script placed in the cgi-bin directory. To run a subdomain CGI script, in the Address field of your Web browser, type http://<subdomain_name>.<domain_name>/cgi-bin/<script_name>  
   where:
   <subdomain_name> is the name of your subdomain
   <domain_name> is the domain name of the site on which your subdomain is hosted
   <script_name> is the name of the cgi script

7. Click Add SubDomain.

If the subdomain has been successfully created, it will be added to the list of existing subdomains. An appropriate message is displayed in the Status panel.

If the process fails, or succeeds with warnings, click the Details link to view related information.