IronPDF Azure/Linux Ubuntu 24.04 Dependency Issue (.NET 9/.NET 10)

Overview

On Ubuntu 24.04, the system library libasound2 was replaced with libasound2t64.

This caused IronPDF to fail at runtime on .NET 9 and .NET 10 Azure Linux images because the expected audio dependency was not installed correctly.

This issue is fully fixed starting from IronPDF 2026.3.x.

Who Was Affected?

This issue affected users who were running:

• Ubuntu 24.04

• .NET 9 or .NET 10 Azure Linux images

• IronPDF versions earlier than 2026.3.x

If you are using IronPDF 2026.3.x or later, the dependency detection has been updated and works correctly.

What Changed in 2026.3.x?

Starting from 2026.3.x:

• IronPDF correctly handles the libasound2t64 change

• Automatic dependency installation works properly

• The issue is resolved for all environments

However, there is one exception explained below.

Important Configuration (Required)

To ensure automatic dependency installation works correctly, you must enable:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

This allows IronPDF to install required Linux packages automatically.

Exception: Non-Docker Linux Environments

In non-Docker Linux environments, the first run may still require sudo because

LinuxAndDockerDependenciesAutoConfig installs system packages using apt.

On standard Linux environments:

• Installing system packages requires root permissions

• apt cannot run without elevated privileges

• This only affects the first run

Docker deployments are not affected, because containers run as root by default.

How to Identify the Permission Issue

If a customer reports a failure even on 2026.3.x, enable logging first:

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.File;
IronSoftware.Logger.LogFilePath = "ironpdf.log"; 

Check the generated log file for errors like:

Executing command 'apt update'
E: Could not open lock file /var/lib/apt/lists/lock - open (13: Permission denied)
E: Unable to lock directory /var/lib/apt/lists/

This confirms the issue is due to missing root permissions.

Solution (Non-Docker Linux Only)

Run the application once with elevated privileges:

sudo -E dotnet run

If dotnet is not found under sudo, use:  

sudo -E ~/.dotnet/dotnet run 

After this first successful run:

• Dependencies are installed

• All future runs work normally

• sudo is no longer required

Summary

Final Recommendation

• Upgrade to IronPDF 2026.3.x or later

• Ensure LinuxAndDockerDependenciesAutoConfig = true

• If running outside Docker, execute once with sudo

After that, IronPDF will function normally on Ubuntu 24.04 with .NET 9 or .NET 10.