Missing libjpeg8 Dependency on Debian 12

Updated:June 9, 2026

On Debian 12, IronPDF 2025.10.8 fails to load its QPdf library at startup because the legacy libjpeg8 package is not included in Debian 12 by default.

IronSoftware.Exceptions.IronSoftwareDeploymentException: Error while deploying QPdf for IronPdf: 'Multiple issues occurred while trying to deploy QPdf (libjpeg.so.8: cannot open shared object file: No such file or directory)

The error may also appear as:

Error while loading '/path/to/runtimes/linux-x64/native/qpdf.so' via libdl2 : '/lib/x86_64-linux-gnu/libjpeg.so.8: version `LIBJPEG_8.0' not found

Debian 12 dropped the legacy libjpeg8 package because it was deprecated in 2017 and replaced with a newer ABI version. IronPDF 2025.10.8 depends on qpdf.so in the runtimes/linux-x64/native directory, which links against libjpeg.so.8. Since that library is absent on Debian 12, the QPdf component cannot be loaded.

Solution

Download the legacy libjpeg8 package from the Debian archive and install it before starting the application. For Docker deployments, add these steps to the Dockerfile:

FROM mcr.microsoft.com/dotnet/runtime:8.0 AS base
USER root
WORKDIR /app

RUN apt update && apt install -y sudo wget
RUN wget https://archive.debian.org/debian/pool/main/libj/libjpeg8/libjpeg8_8b-1_amd64.deb
RUN apt install -y ./libjpeg8_8b-1_amd64.deb

For non-Docker Debian 12 environments, run the same wget and apt commands from a root shell before the first application launch. See the IronPDF Docker guide for a complete Dockerfile structure.

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 19,345,590 | Version: 2026.6 just released