How to Resolve Missing libjpeg8 Dependency on Debian 12 with IronPdf 2025.10.8

IronPdf 2025.10.8 may fail to run on Debian 12 because certain native libraries, such as qpdf.so, require libjpeg8. Debian 12 does not include libjpeg8 by default since it has been deprecated since 2017, causing errors when IronPdf tries to load these libraries.

Issue

When running IronPdf 2025.10.8 on Debian 12, you might encounter the following error:

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) (Failed to locate 'qpdf' at '/app/') (libjpeg.so.8: cannot open shared object file: No such file or directory) (Failed to locate 'qpdf' at '/app') (qpdf.so: cannot open shared object file: No such file or directory) (libjpeg.so.8: cannot open shared object file: No such file or directory) (Failed to locate 'qpdf' at '/app')

(or)

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 (required by qpdf.so)'

This happens because qpdf.so depends on libjpeg8, which is missing in Debian 12.

Solution

You can manually install libjpeg8 from the Debian archive to resolve the dependency.

Steps

1. Download libjpeg8 package:

   RUN wget https://archive.debian.org/debian/pool/main/libj/libjpeg8/libjpeg8_8b-1_amd64.deb

2. Install the package:
   

   RUN apt install ./libjpeg8_8b-1_amd64.deb
   

    

3. Test IronPdf in your application to confirm that the issue is resolved.

Notes

• These commands can be added to your Dockerfile if you are using a containerized environment.

• Installing libjpeg8 manually is necessary only on Debian 12 or other systems where it is missing.

• After installing libjpeg8, IronPdf should load all native libraries correctly and function without runtime errors.