Troubleshooting Chrome Dependencies in IronPDF
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 note
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 $csharpLabelDisable 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
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.