Umbraco and Lets Encrypt SSL

Let’s Encrypt is a free, automated, and open Certificate Authority. It provides a free domain validation SSL certificates for you website that lasts for 90 days, but can be automatically renewed.

When you install the Lets Encrypt SSL it has to validate the domain name and it does this by creating a folder called '.well-known' at the root of your website. However, by default, Umbraco hijacks any request and Lets Encrypt is unable to get to the folder and the validation process fails.

To fix this you need to modify the web.config of your Umbraco website. Update your web.config from

<add key="umbracoReservedPaths" value="~/umbraco,~/install/" />

to

<add key="umbracoReservedPaths" value="~/umbraco,~/install/,~/.well-known" />

Now you can add the Lets Encrypt SSL certificate to your website via the hosting control panel by following these instructions.

Return to Category