Connect a Domain Name



In this lesson we'll connect a bare domain and www domain to Pantheon's Live environment.

Connect Domain

  1. Access the Live environment in your Pantheon Site Dashboard.
  2. Navigate to the Domains / HTTPS page.
  3. Select Connect Domain and enter the www domain (e.g., www.example.com) then click Connect Domain.
  4. Click Back to Domains/HTTPS.
  5. Select Connect Domain and enter the bare domain (e.g., example.com) then click Connect Domain.

Existing Sites

Avoid HTTPS Interruption

Sites that already have HTTPS working can pre-provision certificates and avoid HTTPS service interruption by verifying ownership of the domain.

Warning

Skipping this step will result in service interruption for existing sites that require or expect HTTPS. If you skip this step, HTTPS will be available within an hour after DNS routes to Pantheon.

  1. Access the Live environment in your Pantheon Site Dashboard.
  2. Navigate to the Domains / HTTPS page.
  3. Select Details next to the bare domain.
  4. Click Download File.
  5. Serve the file from your existing live site. Drupal 7 users can use the Lets Encrypt Challenge module to easily serve the contents of the challenge file.

    Note

    The validation file to pre-provision HTTPS must be accessible over HTTP, not just HTTPS. A redirect from HTTP to HTTPS will work, but if a request over HTTP returns a 404, for example, the validation will fail.

  6. Return to the Pantheon Site Dashboard and refresh the Domains / HTTPS page.

After verifying domain ownership, your domain's HTTPS certificate(s) will automatically begin generating and be deployed to Pantheon’s Global CDN within an hour.

When a certificate is ready you can switch DNS destinations from your existing site to your new Pantheon site without HTTPS interruption.

Ready to launch like the pros? Before updating DNS, you can validate HTTPS configuration for the domain is ready on Pantheon by testing locally:

  1. Access the Live environment in your Pantheon Site Dashboard.
  2. Navigate to the Domains / HTTPS page.
  3. Select Details next to the bare domain.
  4. Copy the A record value provided in the Pantheon Site Dashboard.
  5. Add a line to your local hosts file with the IP address from the previous step followed by the domain name, for example:

    192.123.456.789 example.com
    

    This will tell your computer to look for ‘example.com’ at the new Pantheon address.

  6. Make sure your site works with HTTPS by entering your domain with HTTPS in the browser (e.g., https://www.example.com/).

  7. When you finish testing, remove the edits made to your hosts file.

Maintenance Window

If you are unable to prove domain ownership, you will not be able to pre-provision HTTPS to prevent service interruption. In these cases, we recommend completing the next section (Configure DNS) during a planned maintenance window lasting up to one hour. HTTPS will be available for the domain within an hour of pointing DNS to Pantheon.