Set Up HTTPS

LubeLogger runs on Kestrel, which is a cross-platform standalone web server provided by .NET

If you're running LubeLogger behind a reverse proxy(i.e. NGINX), then this walkthrough does not apply to you since the SSL certs will be served up by NGINX instead of Kestrel.

This article covers the step-by-step process to set up HTTPS for a LubeLogger instance.

Docker

If you're running LubeLogger on a Docker instance, first read this article by Microsoft

1. Convert the .PEM / .CRT files into .PFX, read this StackOverflow post
2. Open and modify the .env file and add the following lines(note that in this example I used bob as the password for the cert)

   ASPNETCORE_Kestrel__Certificates__Default__Password=bob
   ASPNETCORE_Kestrel__Certificates__Default__Path=/https/<yourPFXCertificateName>.pfx
   ASPNETCORE_URLS=https://+:443;http://+:80
   

3. Open and modify docker-compose.yml. You will need to bind a new volume to the Docker container so that Kestrel can access the certificate file.

       volumes:
         - ./https/:/https:ro
   

4. Check the port bindings to ensure that traffic is being forwarded to port 443

       ports:
         - 443:443
   

5. Run docker-compose up -d to start up the container and https://localhost will now have a valid cert.

Windows

If you're running LubeLogger as the standalone Windows executable:

1. Convert the .PEM / .CRT files into .PFX, read this StackOverflow post
2. Navigate to the Server Settings Configurator and click Next until you get to "Server Endpoints" Note: Replace 0.0.0.0 with your IPv4 address
3. Save the Settings by clicking to the end of the Server Settings Configurator and click "Save"
4. Restart the app and https://localhost will now have a valid cert.