Referencing the Assemblies

You can install the DynamicPDF HTML Converter NuGet package directly within Visual Studio using the Visual Studio Package Manger.

NOTE: We recommend installing using the NuGet package, as this is the easiest and least error-prone installation method.

Manual Installation

To install manually, download the assembly from the DynamicPDF website. The downloaded zip file (DynamicPDFHTMLConverterForNETv1.XX.zip) contains the following files.

However, the easiest way to install is using NuGet.

Linux Deployment

You can also deploy DynamicPDF HTML Converter on the Linux operating system. The following instructions outline the steps required.

NOTE: The following instructions require DynamicPDF HTML Converter v1.05 or higher.

chromium --headless --no-sandbox --no-gpu

Container Deployment

You can deploy DynamicPDF HTML Converter within a Docker container and deploy it to an Azure App Service or any other similar environment. Here are the steps to create a Docker container. and deploying to Azure App Service. Debian or Ubuntu based images can be used, however Alpine is not supported:

  1. Add Docker support to the ASP.NET project that is using DynamicPDF HTML Converter.

  2. This sample uses Debian. Ubuntu can also be used, however the commands may vary.

  3. Add these lines of code in the docker file to install chromium under the base image.

    # Install chromium
    RUN apt-get update && apt-get install chromium -y

    # Install required fonts. [Optional step]
    # RUN apt update && apt install fonts-indic -y \
    # && fc-cache -f \

  4. Set the TemporaryDirectory and ChromiumProcessPath properties in code when the application starts. If the temporary directory is not preset, it will be created as long as the process has the required permissions.

    Converter.ChromiumProcessPath = "/usr/bin/chromium";
    Converter.TemporaryDirectory = "/dpdfTemp";

  5. Running the application creates the Docker image.

  6. Push the Docker image to the Azure Container registry or Docker Hub and create an App Service using the image.

  7. Refer to this link https://code.visualstudio.com/docs/containers/app-service to Deploy to Azure App Service using VS Code.

In this topic