Gandi Wiki


Questions

Linking your domain to your server

During the creation of your instance, you will be asked for the name of the website that will correspond to the first virtual host declared on your instance.

Add a virtualhost to your instance

To do this, go to the management page of your Simple Hosting instance and scroll down to the "Websites" section.

This section will display a table of all the vhosts that are declared on your instance, as well as the date that you added them.

You can add and delete addresses from this interface. To add an address, simply click on the "Add" button on the lower right of the table.

Next, enter the website address that you want to associate to your instance (without the http://) in the "Address (vhost)" field

Tip:

You need to add the absolute address here. If you declare www.example.com, then you may want to consider using our web forwarding service to forward example.com to www.example.com so that your website can be reached by both addresses).

The following will depend on whether or not your domain is registered with Gandi.

With a domain registered with Gandi

If you are the owner, administrative contact, or technical contact of a domain name that has been added as a vhost, then the DNS zone file will be automatically updated, and you will just need to wait for the propagation to be complete.

You may, however, already have another record on the subdomain that you requested. In this case, you will get an alert to warn you about this and to ask what action you you would like to to.

If you click on "Submit", you will apply the changes, which will overwrite the existing entry for the address in question. In this example, once submitted the address will point to your Simple Hosting instance, though not what it was previously pointing to. If you don't want to apply these changes, click on "Ignore", and you can choose another vhost name.

Important:

If you try to add a vhost of a domain that is at Gandi, but for which your Gandi handle does not have any rights to change the DNS zone file, you will get an error message. In this case, the entry will be done on your domain, but you will need to modify (or request the modification of) the zone file of the domain manually, like you would if the domain was not at Gandi.

With a domain name at another registrar

You will now need to change the zone file by adding (or modifying) a CNAME record in your DNS zone file.

For example: If you wanted to declare www.example.com; you must modify the zone file of the domain example.com by adding a CNAME record for the entry "www". This will look like:

www 10800 IN CNAME gpaas1.dc0.gandi.net.

The value of your CNAME will be different depending on the location of your instance. If it is at Paris, your CNAME entry's value must be gpaas1.dc0.gandi.net. (don't forget the dot at the end).

When the Simple Hosting is made available in the United States, that location's CNAME value must be: gpaas1.dc1.gandi.net.

Finally, you will need to add a TXT entry to your domain name's zonefile, so that we can check that you have the rights to this domain name. The TXT entry is an alphanumeric value. This value will be displayed in our interface in the case you try to add a vhost to a domain name registered outside Gandi (or for which you are not the owner, administrative or technical contact). The entry will look like this:

@ IN TXT www=234567890580d93470770e76e46bab67

Tip:

At some registrars (for example at OVH), it is not possible to input '@' in the 'name' field. In that case just leave the field empty, and add the key as value.

Questions

RSS feed for questions matching this filter (Help)

Last modified: 04 May 2012 at 13:28 by Ryan A. (Gandi)