Using libgdiplus with IronOCR: Setup Guide
.NET Core requires libgdiplus to use the Microsoft System.Drawing.Common NuGet package. If it is not found on macOS or Linux, you may experience this exception:
- Unhandled exception. System.DllNotFoundException: Could not find or load the native library from any name: [ libgdiplus, libgdiplus.so ]
- If you see
System.TypeInitializationException: The type initializer for 'Gdip' threw an exception,then please read our System.Drawing.Common in NET6 guide instead.
Linux
Ubuntu, Debian
To install the required libraries on Ubuntu or Debian, run the following command:
# Update package lists and install necessary libraries
sudo apt-get update && sudo apt-get install -y apt-utils libgdiplus libc6-dev# Update package lists and install necessary libraries
sudo apt-get update && sudo apt-get install -y apt-utils libgdiplus libc6-devSHELL
Docker
Add the following line to your Dockerfile to ensure the necessary libraries are included in your Docker image:
# Update package lists and install necessary libraries in Docker container
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-devmacOS
If you encounter the following exception on macOS:
Unhandled exception. System.DllNotFoundException: Could not find or load the native library from any name: [ libgdiplus, libgdiplus.dylib ]
You can resolve this by:
- Adding the runtime.osx.10.10-x64.CoreCompat.System.Drawing NuGet package to your .NET solution to include libgdiplus in your project.
- Alternatively, manually install the library via Homebrew with the command below:
# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplus# Update Homebrew and install mono-libgdiplus
brew update && brew install mono-libgdiplusSHELL
- More information is available on the official .NET documentation.
Ready to Get Started?
Nuget Downloads 4,891,631 | Version: 2025.10 just released
