Articles in this section
Category / Section

Blank PDF is generated when converting HTTPS sites to PDF in Azure

2 mins read

When converting HTTPS sites, blank paged PDF may occur due to missing of the OPENSSL assemblies in Azure website. To convert HTTPS sites, the converter requires OPENSSL assemblies. By default, some Azure websites do not have the OPENSSL assemblies. So, these assemblies should be added to the website explicitly.

Refer to the following links for prerequisites and converting HTML to PDF in Azure.

You can get the OPENSSL assemblies from the development machine, if HTTPS conversion is working on the development environment. Also, you can get the OPENSSL assemblies by installing the OPENSSL software. Please refer to the following links for more information,


You can also get the OPENSSL assemblies from below link,

OPENSSL binaries:   

Steps to overcome the blank PDF issue on Azure website:

.NET Framework:

  1. Create a new folder in a project and copy the OPENSSL assemblies to that folder.
  2. Include that folder in a project and set copy to the output directory as “Copy always”.
  3. Get the path of the OPENSSL assemblies folder in C# and set it to the environment variable. Refer to the following code snippet.
    //Set Environment variable for OpenSSL assemblies folder 
    string SSLPath = Server.MapPath("~/OpenSSL"); 
    Environment.SetEnvironmentVariable("Path", SSLPath); 


Refer to the following screenshot for more information. Screenshot for copy OPENSSL assemblies

.NET Core:

  1. Copy the OPENSSL assemblies into the QtBinariesDotNetCore folder. Refer below screenshot, Screenshot for copy assemblies into QtBinariesDotNetCore.
  2. Then set the copy to output directory as “Copy always” for all the files under QtBinariesDotNetCore folder.
  3. There is no need to set environment variable for OPENSSL, the converter can access the OPENSSL assemblies from the QtBinariesDotNetCore folder itself.

    If we set environment variable for OPENSSL in .NET core, then the conversion may get failed in Azure.



Did you find this information helpful?
Help us improve this page
Please provide feedback or comments
Please sign in to leave a comment