External DNS - Resolving to subdomain
This guide provides an overview of how to set up a custom domain on a Production Instance using an external DNS web service, as well as create and provision an AWS SSL certificate for your Instance.
We are continuously improving the UX of this functionality, trying to make it as user-friendly as possible. Some changes may apply.
To be able to set up a production domain on the Partner Portal, you have to have access to the Partner Portal, have a production Instance, and you should be familiar with the recommended development workflow.
There are a couple things to consider before you add a custom domain to your platformOS production Instance:
- A domain can only be added on a production data center. This means that you cannot set up an additional domain on a staging data center Instance.
- PlatformOS Instances require the ability to apply a Fully Qualified Domain Name (FQDN) to a DNS record. If your DNS management service does not allow for that, you will need to change providers or opt to use the free fully integrated hosted zone that is provided to you as a benefit of hosting with platformOS. When setting up your custom domain, this is the first decision you must make.
- We automatically provision and deploy AWS SSL certificates when you add a domain to a platformOS Instance. To apply custom SSL certificates, please contact support@platformOS.com and we will assist further.
External DNS and resolving to a subdomain and using EXTERNAL DNS service (example: https://123.example.com)
- In our example, we are assuming that your domain has already been set up before with your DNS provider and all records are in place from previous usage.
- Go to the Instance detail page in the platformOS Partner Portal: https://partners.platformos.com
Add new domain to your Instance.
External DNS management.
- Add your subdomain name (do not add www), will this be your default domain, click
Create External DNS management
- Refresh your page a few times until the status on the Domains page changes to
ownership_verification_pending. Once it does, click
- We need to validate ownership of the subdomain so, in your DNS provider, please add the required CNAME record.
- Once you have added the CNAME,instance you can click
Ok. Done. I added requested records.
- Refresh the page a few times (this may take longer) to allow for our system to verify the CNAME. Once it's done, you'll be provided with a couple options for FQDN's depending if your DNS provider is AWS or another provider. You'll also be asked to add the www CNAME record if you have not done so already for your domain. The reason for this is we automatically set up the www subdomain and redirect the root domain to it.
When you are ready to "Go Live", please continue.
- Add the provided FQDN to DNSMadeEasy as an ANAME record.
- Now we need to remove the WWW redirect. From the instance detail page, click on
- We will improve this shortly, but for now, in the URL that appears, remove the
/pp_dns. Example, https://partners.platformos.com/instances/5253/pp_dns/domains we would change to https://partners.platformos.com/instances/5253/domains - From this page, we will remove the redirect from root to www, and add a redirect from www to root. Click
Editon the root domain.
- Make sure that
Use as defaultis checked and that
redirectis unchecked. Then click
- Next, click on
editfor the www subdomain.
- Finally, make sure
Use as defaultis unchecked and check
redirect. Add the direct URL to the root domain and then choose your redirect code. Once completed, click
Congratulations! An SSL certificate has been created and applied to your instance and your domain is now LIVE!