Troubleshooting Chrome Dependencies in IronPDF

Updated:June 22, 2025

The Google Chromium HTML renderer is an essential part of IronPDF's "Html To PDF" rendering process. The essential binary for this renderer should be readily found inside the IronPDF NuGet package. Absence of this binary from the project folder will throw the following error:

Unhandled exception. IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying IronPdf Chrome renderer: 'Unable to locate 'IronInterop'.

If IronPDF is unable to deploy Chrome Dependencies automatically, they may need to be added to a project manually via NuGet. Multiple dependencies can be added:

Please noteIn later versions of IronPDF, the required binaries will be automatically downloaded from the NuGet source based on the OS used during runtime, if they are absent from the project folder. This will be successful as long as the project is connected to the Internet and has Read, Write, and Execute permission to the project folder.

On Windows, it is a good idea to ensure the target operating system has Visual C++ Runtimes installed. Many modern applications cannot run without this essential operating system component.

We also have compatibility guides for Linux and Docker.

Linux

Ensure the correct Docker file is used.
Use the IronPdf.Linux NuGet package instead of IronPdf.

Set GPU mode for Chrome rendering to disabled:

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled;

IronPdf.Installation.ChromeGpuMode = IronPdf.Engines.Chrome.ChromeGpuModes.Disabled

$vbLabelText $csharpLabel

Disable the automatic configuration for Linux and Docker dependencies:

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp
Installation.LinuxAndDockerDependenciesAutoConfig = false;

csharp Installation.LinuxAndDockerDependenciesAutoConfig = False

$vbLabelText $csharpLabel

MacOS

Check that the .NET runtime is set to the correct architecture - x64 or arm64.

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 for 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 before running any IronPDF methods (all versions after 2021.3.1):

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

// Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log";
// Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;

' Set the log file path, this can be a directory or a full file path
IronPdf.Logging.Logger.LogFilePath = "Default.log"
' Enable all logging modes for detailed logging information
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All

$vbLabelText $csharpLabel

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.

Chaknith Bin

Chat with engineering team now

Software Engineer

Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience.