Managing domains and certificates

    Under Settings in the Umbraco Cloud Portal, you'll find Manage domains. This is where you go when you want to bind domains to your Cloud environments and when you want to add security certificates to your environments.


    When you've finished building your website with Umbraco Cloud you most likely want to bind a hostname to your project. This can be done from Manage domains.

    Manage domains

    You can bind any hostname to your project environments. Keeping in mind, of course, that the hostname will need to have a DNS entry so that it resolves to the Umbraco Cloud service.

    You can bind a total of 15 hostnames to each Umbraco Cloud environments.

    Once you add a domain to one of your environments make sure to update the hostname DNS entry to resolve to the service. We recommend setting an ALIAS record for your root domain (e.g., rather than an A record for the service IP address. Check with your DNS host or domain registrar for details on how to configure this for your domain.

    You will also need to add the hostnames to your root content node.

    • Go to the Umbraco Backoffice
    • Right-click the root content node
    • Choose Culture and Hostnames
    • Add your hostname
    • Hit Save

    Culture and Hostnames

    Hiding the Default Url

    We create your project’s URL based on the name of the project project, and then we add If you named your project Snoopy, your project URL will be and your project’s Umbraco backoffice URL will be For the Development environment we prefix with dev- so the URLs will be and You'll find all environments for a project listed on the Project page.

    Once you've assigned a hostname to your Live environment you may want to "hide" the projects default URL (e.g. for various reasons. Perhaps for SEO or just making it clear to your users that the site can be accessed using just one hostname.

    One approach for this is to add a new rewrite rule to the <system.webServer><rewrite><rules> section in the web.config file. For example, the following rule will redirect all requests for the projects URL to the URL and respond with a permanent redirect status.

    <rule name="Redirects to actual domain" stopProcessing="true">
      <match url=".*" />
        <add input="{HTTP_HOST}" pattern="^(.*)?$" />
        <add input="{REQUEST_URI}" negate="true" pattern="^/umbraco" />
        <add input="{REQUEST_URI}" negate="true" pattern="localhost" />
      <action type="Redirect" url="http://<your actual domain here>.com/{R:0}" 
              appendQueryString="true" redirectType="Permanent" />

    Note: This will not rewrite anything under the /umbraco path so that you can still do content deployments. You don't have to give your editors the URL, and they won't see the URL if you give them the actual domain name. This rule will also not apply on your local copy of the site running on localhost.

    Security Certificates

    Manage certificates

    On the Manage domains page you'll also find option to upload and configure SSL certificates for your Cloud environments.

    Your certificates need to be .pfx format and must be set to use a password. Each certificate can then be bound to a hostname you have already added to your site. Make certain you use the hostname you will bind the certificate to as the common name (CN) when generating the certificate.

    Running your site on HTTPS only

    Once you've applied a certificate to your site you can make sure that anybody visiting your site will always end up on HTTPS instead of the insecure HTTP.

    To accomplish this, add a rewrite rule to the live environment's web.config in the <system.webServer><rewrite><rules> section.

    For example, the following rule will redirect all requests for the site URL to the secure URL and respond with a permanent redirect status.

    <rule name="HTTP to HTTPS redirect" stopProcessing="true">
      <match url="(.*)" />
        <add input="{HTTPS}" pattern="off" ignoreCase="true" />
        <add input="{HTTP_HOST}" pattern="localhost" negate="true" />
      <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />

    Note: This redirect rule will not apply when the request is already going to the secure HTTPS URL. This redirect rule will also not apply on your local copy of the site running on localhost.