Custom domain setup

purple provides easy and convenient support for custom domains on your web experience website this article guides you through the set up of a custom domain for your purple web experience if you encounter any issues, please contact purple support for assistance preconditions an available sub domain unless your dns provider supports alias/aname records, you cannot use the root (apex) domain but instead need to use a sub domain example example org is the root domain www example org is a subdomain of example org if you use a sub domain, you will need to take care of forwarding the http requests from the root domain to the sub domain yourself we do not provide this functionality access to the dns server configuration of that domain a purple app with configured web experience the domain must not use cloudfront if the domain is already set up with a cloudfront instance, it first must be removed from the other cloudfront to set up cloudfront with purple how to guide 1\ go to purple manager – 'apps' – 'overview' 2\ click on the three dots menu 3\ click on 'experience' in the dropdown 4\ next to 'web newsstand domain' enter your desired domain name for the web experience for example, epaper example com 5\ click on 'update' 6\ click on 'ok' 7\ wait until the page shows dns records for the certificate 8\ configure the dns records in your dns server configuration create the cname record with the data shown in the ui aws needs this entry to be able to create a ssl certificate for the domain to use with the cloudfront cdn example the screen shows the following data you then need to create a cname entry in your dns tool, e g in aws route 53 it may take a few minutes for aws to check and create the certificate after you created the dns entry do not remove this record after successful configuration it is needed for continued ssl support (renewal of certificates) 9\ wait until the page in purple manager shows the domain name for the cloudfront domain 10\ configure the custom domain to point to the cloudfront domain using a cname in the dns server configuration similar as done in step 8, you will need to create a dns entry for the domain like this this step can be done at a later time, e g when the website should be made available to prepare for a switch over, all previous steps should be done at least 24 hours before the planned switch the existing dns entries should also be switched to a lower ttl value in advance so that the cut over time is as short as possible 11\ after a few minutes, the experience should be accessible via that domain name you have successfully configured the domain for your web experience, and the site is now publicly accessible troubleshooting i created a dns entry for the certificate / cloudfront domain but the setup process does not continue / the website is not available firstly, confirm that the dns entry is created correctly you can do this using the following command line tools, usually available on windows, macos or linux windows open the command prompt (cmd) and enter the following nslookup q=cname \<value from name row> nslookup q=cname e1afc13b486d97d694b187913cdfa952 example sprylabprojects com it should show either, in case of success, c \users\myuser>nslookup q=cname a87a7a5ba89b3e7b6271912bdd9d7414 example sprylabprojects com server \<your router> address 10 0 0 1 non authoritative answer a87a7a5ba89b3e7b6271912bdd9d7414 example sprylabprojects com canonical name = e1afc13b486d97d694b187913cdfa952 htgdxnmnnj acm validations aws or, in case of error, c \users\myuser>nslookup q=cname e1afc13b486d97d694b187913cdfa952 example sprylabprojects com server \<your router> address 10 0 0 1 \<your router> can't find e1afc13b486d97d694b187913cdfa952 example sprylabprojects com non existent domain linux / macos open a terminal and enter the following command to check if the dns entry exists, e g $ host e1afc13b486d97d694b187913cdfa952 example sprylabprojects com it should either show in case of correct setup $ host a87a7a5ba89b3e7b6271912bdd9d7414 example sprylabprojects com a87a7a5ba89b3e7b6271912bdd9d7414 example sprylabprojects com is an alias for 92c59670aad38d1f043be9d9f77119f4 htgdxnmnnj acm validations aws or in case of an error $ host e1afc13b486d97d694b187913cdfa952 example sprylabprojects com host e1afc13b486d97d694b187913cdfa952 example sprylabprojects com not found 3(nxdomain) if there is an error shown, this means that the dns entries are incorrect or not fully published yet depending on your provider it may take some time for changes to the dns to become active please verify the created dns records match exactly what was provided and shown here in the examples