Architecture

A domain mapping works by associating the CNAME entry of your domain with the Catalyst hosting site in your domain’s DNS configuration. You can learn about the steps to do it in detail in the Implementation section.

You must add two CNAME records for your domain to link it with Catalyst in your domain’s DNS configuration. You must use the unique hash key value generated for the mapping by Catalyst in the second CNAME record. This will verify your ownership of the domain and create a unique mapping on both ends.

After verifying your ownership of the domain, Catalyst will create a unique key-value pair for the DNS entry, which will associate that particular domain with the specific Catalyst application. It will maintain a reverse mapping of the domain and the application endpoint. This ensures that the domain is uniquely associated with only one Catalyst application until the mapping is deleted.