How to Get the Best Support for IronOCR

Updated:June 1, 2025

Thank you for taking the time to get IronOCR working properly. We have a team of engineers working to improve IronOCR with regular releases. Updates are often deployed on NuGet every 1 to 2 months.

To help us help you, we need to categorize the issue you are having into one of the following types:

Exceptions and Bugs

If you receive a fatal error with IronOCR that stops you from using our code, we want to know! The clearer the bug report, the faster it will be resolved. Please report it by following instructions on our Exceptions & Bug Reporting Page to isolate the issue.

Reading our troubleshooting guides and language pack FAQs may make you aware of common issues and limitations of IronOCR.
If your issue is in the following list of known issues, a solution may already be available:

Known Deployment Issues

If your solution works locally but fails when deployed to another machine, we would love to improve our support of that platform and appreciate you making a bug report with details of the machine where the issue occurs.

Windows

System.Exception: Could not initialize Tesseract. The fallback logic failed.
- Please install Visual C++ Runtimes on Windows for both 32-bit and 64-bit runtimes.
Unhandled exception: System.Runtime.InteropServices.SEHException
- This is a known limitation for supporting Celeron and Atom processors. A planned fix is in progress.

Linux, Docker, and MacOS

Unhandled exception. System.DllNotFoundException: Could not find or load the native library from any name: [ libgdiplus, libgdiplus.so ] or [ libgdiplus, libgdiplus.dylib ]
- You may need to install libgdiplus to support System.Drawing.Common on your Linux or MacOS operating system.
System.TypeInitializationException: The type initializer for 'Gdip' threw an exception.
- .NET 6 specific issues on Linux and Mac. You may need to add support for Microsoft System.Drawing.Common to your .NET 6 project or use .NET Framework, Core 3.1, or .NET 5 until this general limitation of .NET 6 is improved.

Azure Functions v3 and v4

Exceptions about "OCRData file not found" can be resolved using our Azure function deployment guide.

Licensing

Our most common questions are about licensing:

How to get licensed for IronOCR and which license applies to your use case.
How to apply a license key for commercial deployment is also a very common article.

_If these do not apply or assist in resolving the issue and you would like to request assistance from one of our highly trained engineers, please follow this guide to produce the swiftest resolution._

Curtis Chau

Chat with engineering team now

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.

...

Ready to Get Started?

Nuget Downloads 5,036,217 | Version: 2025.11 just released