IRONSOFTWAREHOME

Resolving PDFium Dependency Errors

Curtis Chau
Curtis Chau
Updated: July 21, 2026

The Google PDFIUM is an essential component of IronPDF's core code, utilized for various functions related to PDF editing and the conversion of PDF documents to images. If the PDFIUM binary is missing from the project folder, the following error will be thrown during runtime.

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying Pdfium for IronPdf: 'Unable to locate 'IronPdfInterop'
Text

Installing IronSoftware.Native.PdfModel package into the project will usually remedy the issue.

On Windows, it is also a good idea to ensure the target operating system has Visual C++ Runtimes installed.

What to do if that does not solve it?

If that does not fix the issue, we are here to assist. Compatibility is a high priority to our engineering team. Please send an email bug report to support@ironsoftware.com. All compatibility issues will be seriously reviewed by a senior engineer.

Be sure to let us know about the operating system / platform being deployed to, especially if it is a cloud platform like AWS or Azure.

How to Enable Native Logging in IronPDF

Attaching Log Files to a bug report more than doubles the probability that we can isolate the issue and solve it rapidly.

Place this at the top of your code, prior to running any IronPDF methods (all versions after 2021.3.1).

// Enable debugging to generate detailed log files for troubleshooting.
IronPdf.Logging.Logger.EnableDebugging = true;

// Set the path for the log file. You can specify a directory name or a full file path.
IronPdf.Logging.Logger.LogFilePath = "Default.log";

// Set the logging mode to log all events.
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

Log files created by IronPDF are found in the /bin directory of your project where your DLLs are deployed:

  • default.log (Deployment process)
  • cef.log (Rendering)
  • IronSoftwareCefSubprocess.log (Rendering & Threading)
  • IronSoftwareEngine.log (Useful for debugging exceptions beginning with "Error generating PDF from...")

Cloud Servers often have specific locations for log files. We have guides for generating log files in Azure and AWS.

Curtis Chau
Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...
Read More

Ready to Get Started?

Nuget Downloads 21,105,021Version:2026.9just released

Get your free 30-day Trial Key instantly.
No credit card or account creation required
C# NuGet Library for PDF
Install with NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. In Solution Explorer, right-click References, Manage NuGet Packages
  2. Select Browse and search "IronPdf"
  3. Select the package and install
C# PDF DLL
Download DLL

Version: 2026.9

or download Windows Installer here.

  1. Download and unzip IronPDF to a location such as ~/Libs within your Solution directory
  2. In Visual Studio Solution Explorer, right click References. Select Browse, "IronPdf.dll"

Licenses from $999

Key in blue circle

Get your free 30-day Trial Key instantly.

Your trial license will be sent to your email address

No limitations. 100% unlocked. No credit card.

OR
bullet_checkedNo credit card or account creation requiredNo limitations. 100% unlocked. No credit card.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Book your free Live Demo
Booking Badge

Trusted by Millions of Engineers Worldwide

Iron Software's customer logos
Get Your No-Obligation Consult
Complete the form below or email sales@ironsoftware.com
Your details will always be kept confidential.
Trusted by Millions of Engineers Worldwide
Iron Software's customer logos
Get your free 30-day Trial Key instantly.
No credit card or account creation required
C# NuGet Library for PDF
Install with NuGet

Version: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. In Solution Explorer, right-click References, Manage NuGet Packages
  2. Select Browse and search "IronPdf"
  3. Select the package and install
C# PDF DLL
Download DLL

Version: 2026.9

or download Windows Installer here.

  1. Download and unzip IronPDF to a location such as ~/Libs within your Solution directory
  2. In Visual Studio Solution Explorer, right click References. Select Browse, "IronPdf.dll"

Licenses from $999