IronPDF Ubuntu 24.04 Dependency Issue on .NET 9 and .NET 10

Curtis Chau

Updated: June 10, 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # IronPDF Ubuntu 24.04 Dependency Issue on .NET 9 and .NET 10 On Ubuntu 24.04 with .NET 9 or .NET 10, IronPDF fails to install its required system dependencies at startup. This affects Azure Linux images and non-Docker Linux environments where the application does not run with root privileges. ```txt E: Could not open lock file /var/lib/apt/lists/lock - open (13: Permission denied) E: Unable to lock directory /var/lib/apt/lists/ ``` Ubuntu 24.04 renamed the audio library from libasound2 to libasound2t64. IronPDF's automatic dependency installer targets the original libasound2 package name and cannot acquire the APT lock when running as a non-root user, producing the permission error shown above. ## Solution ### Option 1: Enable automatic dependency configuration (Docker and Azure Linux) Set `LinuxAndDockerDependenciesAutoConfig` to `true` before the first render call: ```csharp IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true; ``` To capture diagnostic output during startup, enable file logging: ```csharp IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.File; IronSoftware.Logger.LogFilePath = "ironpdf.log"; ``` ### Option 2: First-launch with elevated privileges (non-Docker Linux) For non-Docker Linux environments, run the application once with elevated privileges so IronPDF can install the required packages: ```bash sudo -E dotnet run ``` If `dotnet` is not found under sudo, use the full path: ```bash sudo -E ~/.dotnet/dotnet run ``` After the first launch installs dependencies, subsequent runs do not require elevated privileges. For the full list of packages required on Ubuntu 24.04, see the [Linux deployment guide](/get-started/linux/). [[n:(This issue was resolved in IronPDF 2026.3.x. Upgrading to that version or later means the libasound2t64 library rename is detected automatically without requiring manual configuration.)]]

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

On Ubuntu 24.04 with .NET 9 or .NET 10, IronPDF fails to install its required system dependencies at startup. This affects Azure Linux images and non-Docker Linux environments where the application does not run with root privileges.

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

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

Ubuntu 24.04 renamed the audio library from libasound2 to libasound2t64. IronPDF's automatic dependency installer targets the original libasound2 package name and cannot acquire the APT lock when running as a non-root user, producing the permission error shown above.

Solution

Option 1: Enable automatic dependency configuration (Docker and Azure Linux)

Set LinuxAndDockerDependenciesAutoConfig to true before the first render call:

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

To capture diagnostic output during startup, enable file logging:

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

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

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

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

Option 2: First-launch with elevated privileges (non-Docker Linux)

For non-Docker Linux environments, run the application once with elevated privileges so IronPDF can install the required packages:

sudo -E dotnet run

sudo -E dotnet run

If dotnet is not found under sudo, use the full path:

sudo -E ~/.dotnet/dotnet run

sudo -E ~/.dotnet/dotnet run

After the first launch installs dependencies, subsequent runs do not require elevated privileges. For the full list of packages required on Ubuntu 24.04, see the Linux deployment guide.

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.

...

Read More