Managing custom domain names in Umbraco Cloud involves tasks such as setting up a new custom domain or temporarily disabling an existing one. This guide provides step-by-step instructions to help you effectively configure domain and DNS settings.
Setting Up a Custom Domain Name
To use a custom domain name with your Umbraco Cloud site, follow these steps from the Umbraco Managing Hostnames documentation:
Update DNS Records: Log into your domain registrar's control panel and update your DNS records to one or both of the following:
1. Add a CNAME record that points to dns.umbraco.io. Ensure you do not point directly to umbraco.io, as it may lead to instability.
2. Add A records pointing to 162.159.140.127 or 172.66.0.125.
3. Add AAAA records 2606:4700:7::7d or 2a06:98c1:58::7d.
4. Add Hostnames in Umbraco: Navigate to the 'Hostnames' section in your Umbraco project. Add both versions of your domain: - The version with www (e.g., www.yourdomain.com) - The version without www (e.g., yourdomain.com) Ensure
DNS Propagation: Verify that DNS settings are correctly propagated and functional. If you need an A-record instead, ensure it points to one of the recommended IP addresses provided in Umbraco's documentation. SSL Alignment: To secure your domain, use a custom SSL certificate. Ensure that the Web Application Firewall, if in use, and your domain use matching SSL certificates to avoid handshake errors. Handle A Record Conflicts: Remove or replace any existing A records in your DNS zone to prevent conflicts and ensure your hostname resolves to the correct destination. Optionally, you can configure A records pointing to Umbraco's anycast IPs, although a CNAME record is sufficient in most cases.
Temporarily Disabling a Custom Domain
If you wish to temporarily turn off your custom domain, the following steps will help:
Remove Hostnames from Umbraco: Access your Umbraco portal and remove the hostname assigned to your custom domain. This action will effectively disable your custom domain.
Revert DNS Records: If your domain's DNS records were pointing to another hosting environment before, you may need to restore those original DNS configurations.
Additional Information and Tips
Changes in DNS Settings: Allow sufficient time for DNS changes to propagate globally. This process can take up to 48 hours. Consult Documentation: For specific IP addresses or CNAME target details, refer to the latest Umbraco Cloud documentation. SSL Handshake Prevention: Mismatched SSL certificates between the Web Application Firewall and your domain can result in handshake failures. Ensure certificate alignment to avoid connection disruptions. Remove Conflicts: Leaving conflicting A records unresolved can lead to DNS resolution problems, such as failing to resolve the hostname or resolving it incorrectly. Removing these records is vital for a smooth setup. CNAME vs A Record: A CNAME record pointing to [dns.umbraco.io](https://dns.umbraco.io) suffices for most setups. While A records are not mandatory, you may optionally configure them for specific use cases.
Related Topics
By following these steps, you can confidently manage the DNS and domain settings for your Umbraco Cloud site.