Cleaner Scanning Fails on Linux ARM64

Curtis Chau
Curtis Chau
Updated: November 5, 2026

Before 2026.11.1, the YARA library IronPDF bundles for Linux ARM64 is a different build from the one on other platforms, so Cleaner.ScanPdf() cannot load its scanner and throws Cleaner scanning function is not working. The inner error depends on the machine's glibc version.

On glibc 2.33 or newer (for example Debian 12 or Ubuntu 22.04):

IronPdf.Exceptions.IronPdfProductException: Cleaner scanning function is not working. ---> IronSoftwareAssemblyLoadException: /app/libyara.so: undefined symbol: string__declarations
Text

On older glibc (for example Ubuntu 20.04 or Debian 11):

IronPdf.Exceptions.IronPdfProductException: Cleaner scanning function is not working. ---> IronSoftwareAssemblyLoadException: /lib/aarch64-linux-gnu/libc.so.6: version `GLIBC_2.33' not found (required by /app/libyara.so)
Text

The ARM64 libyara.so in releases before 2026.11.1 refers to functions that are not present and needs a newer glibc, so it fails to load either on the glibc check or on the missing string__declarations symbol. 2026.11.1 ships an ARM64 libyara.so rebuilt from YARA 4.1.1 to match the x64 build, with no missing symbols and a glibc 2.17 requirement.

This affects .NET on Linux ARM64 (any distribution) using the IronPdf.Linux.ARM package, whether running bare, in Docker, or on ARM64 cloud instances such as AWS Graviton.

Solution

Recommended: Upgrade IronPDF to 2026.11.1 or later, then run Cleaner.ScanPdf() again.

dotnet add package IronPdf.Linux.ARM --version 2026.11.1
SHELL

The upgrade fixes the YARA library only. HTML rendering on Linux ARM64 still needs glibc 2.34 or newer, for example Ubuntu 22.04 or Debian 12. On an older glibc, Cleaner.ScanPdf() works after the upgrade, but rendering does not.

What Doesn't Work

Moving to a newer glibc or base image without upgrading IronPDF does not help: the glibc error changes to the string__declarations error, and the scan still fails.

See the IronPDF changelog and the Linux deployment guide for more detail.

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.

Read More

Ready to Get Started?

NuGet Downloads 22,198,312Version:2026.11just released