Do I need libgdiplus?

View as MarkdownMarkdown

Set up your AI agent

Give your coding agent live access to the GroupDocs documentation and API reference through the GroupDocs Docs MCP server — no install, no API key. Learn more

claude mcp add --transport http groupdocs-docs https://docs.groupdocs.com/mcp

Also process documents locally

The GroupDocs.Viewer MCP server lets your agent work with files on your machine; they are never uploaded. It needs the .NET 10 SDK or Docker.

claude mcp add groupdocs-viewer -- dnx GroupDocs.Viewer.Mcp --yes
Folders, licensing and more →

No. Since version 26.9, GroupDocs.Viewer for Python via .NET does not need libgdiplus on Linux or mono-libgdiplus on macOS. The Linux and macOS packages render through SkiaSharp and Aspose.Drawing, which ship inside the wheel. Every documented example passes in a Linux container with no libgdiplus installed.

If an older version of this guide, a Dockerfile, or a CI script installs libgdiplus for GroupDocs.Viewer, you can remove it. The packages that are required on Linux are fonts, fontconfig and ICU — see System Requirements.

Windows never needed libgdiplus: GDI+ is part of the operating system.

If a libgdiplus error still appears

An error such as DllNotFoundException: Unable to load shared library 'libgdiplus' or The type initializer for 'Gdip' threw an exception is not expected with 26.9 or later. Check that you are running a current version:

python -c "import groupdocs.viewer as gv; print(gv.__version__)"

If you are on 26.9 or later and still see the error, install the library as a workaround and report the document that triggered it, so the rendering path can be fixed:

Debian / Ubuntu

sudo apt-get update
sudo apt-get install -y libgdiplus

Red Hat / CentOS / Rocky (from the EPEL repository)

sudo yum install -y epel-release
sudo yum install -y libgdiplus

macOS

brew install mono-libgdiplus

To confirm that the library is visible to the loader on Linux:

ldconfig -p | grep libgdiplus