Configuring a new domain

Overview

This guide will walk you through the steps needed to add a domain to an existing Section environment. For help understanding whether adding an new domain to an existing environment is best for your use case, please visit this guide. If you wish to set up an entirely separate application for this domain or have reached this page without following the going live tutorial please see the getting started guide for a comprehensive guide to every step of the go live process.

Note as well the DNS guidelines for running multiple domains on one environment.

Step 1 - Adding the domain

  1. Navigate to the DNS section of your existing Section application.
  2. Click the Add domain button and input the desired domain.
  3. Hit save.

This will configure the Section platform to route all requests for your desired domain through this environment’s module stack.

Step 2 - Configuring DNS

You will need to make the DNS record for the domain you added point to the CNAME record automatically generated for that specific domain for traffic to flow through the Section platform.

Assume we added www.example.com

  1. Navigate to your DNS hosting provider.
  2. Add a CNAME record for www.example.com
    • The value will be www.example.com.c.section.io
  3. Save your changes.

You can test these configurations by utilizing dig to perform a DNS lookup to ensure the domain is pointed to your Section record. You can also use a web based tool to perform DNS lookups. Note that the DNS change can take time to propagate based upon your old record’s TTL values.

Example dig command: dig +trace www.example.com @8.8.8.8

All domains added to the Section platform will generate a unique CNAME record. This CNAME record follow the naming convention domain.c.section.io.

Step 3 - SSL Certificate

Follow the how to guide on provisioning an SSL certificate.