Click or drag to resize
Pdf Library for .NET

Deployment

To deploy a project that uses SelectPdf, 3 files need to be deployed: Select.Pdf.dll, Select.Html.dep, Select.Tools.dep. There are no additional setups or configurations needed either on your server or your client's machine.

If Blink rendering engine is used (only works with the .NET Core version and with .NET Framework 4.6.1 or above), Blink binaries (full Chromium folder) also need to be deployed.

If the Chromium rendering engine is used, the Chromium runtime folder installed by the matching Chromium.Windows Nuget package must also be deployed alongside the application. When the project references the Chromium.Windows package, MSBuild places that folder in the application output directory automatically at build time, so a standard publish operation picks it up. See Chromium Engine for details.

Important note  Important

Full trust is required on the deployment machine. SelectPdf makes numerous native API calls, thus it requires full trust to run.

GAC Installation

If you plan to install Select.Pdf into GAC, the only dll that needs to be added to GAC is Select.Pdf.dll. The related files (Select.Html.dep and Select.Tools.dep) will be automatically copied to GAC as linked resources, so no additional action is needed for them.

Deployment to a Shared Hosting Environment

If you plan to deploy Select.Pdf to a shared hosting environment, please check with your hosting company whether they support full trust. SelectPdf makes numerous native API calls, thus it requires full trust to run. If your hosting company cannot grant full trust to your site, you may need to consider moving your site to a dedicated or virtual server.

Deployment to Windows Azure

If you plan to deploy SelectPdf to Windows Azure, make sure you deploy to a Cloud Service or a Virtual Machine. Due to some security restrictions, SelectPdf does not support Windows Azure WebSite execution mode. To resolve the issue, you can either deploy your site to a Cloud Service or a Virtual Machine, or isolate the PDF related feature into a separate Web Service that runs on a different server (either on a Windows Azure Cloud Service/Virtual Machine, or a dedicated server hosted elsewhere), then call the web service from your Windows Azure WebSite.

Update: Starting with version 18.3, SelectPdf supports Microsoft Azure Web Apps (Basic plan or above) with some limitations. More details here: Deployment to Microsoft Azure.

Update: Starting with version 26.2, SelectPdf also supports Microsoft Azure Web Apps (Basic plan or above) using the Chromium rendering engine, with the full feature set. See Chromium Engine for how to install and select the Chromium engine, and Deployment to Microsoft Azure for the full Azure deployment discussion.

See Also