Dvoituron.Tools.AzureLetsEncrypt 1.4.0

dotnet tool install --global Dvoituron.Tools.AzureLetsEncrypt --version 1.4.0
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local Dvoituron.Tools.AzureLetsEncrypt --version 1.4.0
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Dvoituron.Tools.AzureLetsEncrypt&version=1.4.0
nuke :add-package Dvoituron.Tools.AzureLetsEncrypt --version 1.4.0


Simple tool to add a Let's Encrypt SSL certificate to your websites. This application is a .NET Core tool that generates an SSL certificate, validated it with LetsEncrypt.

2 minutes of a live demo: https://youtu.be/OCKpC1W4Wks

Steps to generate and to validate a certificate

Prerequisite: you must have a website accessible from your domain name (in http). Indeed, the validation of LetsEncrypt tries to check the presence of a file available in your website.

  1. Go to Azure portal, navigate to your Advanced Tools (Kudu environment). And select Debug console / CMD.

  2. Install this tool, using this command from the folder D:\home\site.

     dotnet tool install dvoituron.tools.azureletsencrypt --tool-path tools
  3. Run this command, using your domains and password.

     .\tools\AzureLetsEncrypt --domains=mydomain.com,www.mydomain.com --password=MyPassword
  4. You can download your validated Pfx certificate from the subfolder ./store of your website.

  5. In the Azure portal, go to SSL settings panel, to upload your Pfx.

    • Private certificate: upload your Pfx file (using your password)
    • Bindings: Add a SSL Binding using a SNI based

When to renew the certificate?

LetsEncrypt's certificates expire after 90 days. This is an obligation imposed by LetsEncrypt. So, you need to reproduce these steps, each 3 months.

More about this project

The detailled steps to create a SSL certificate and validate it with the Let’s Encrypt Certificate Authority are described on my blog. This tool automates these steps.

If you want generate and publish automatically your certificate, see https://github.com/dvoituron/AzureLetsEncrypt

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.1 is compatible.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last updated
1.4.0 836 12/4/2019
1.3.0 644 6/12/2019