IronPDF Linux Compatibility & Setup Guide

IronPDF supports Linux for .NET 8, 7, 6, 5 and .NET Core applications, as well as Docker, Azure, AWS, macOS, and (naturally) Windows.

Linux V1 related to IronPDF Linux Compatibility & Setup Guide Docker related to IronPDF Linux Compatibility & Setup Guide Azure 1 related to IronPDF Linux Compatibility & Setup Guide Amazon Web Services related to IronPDF Linux Compatibility & Setup Guide Ubuntu V1 related to IronPDF Linux Compatibility & Setup Guide Debian V1 related to IronPDF Linux Compatibility & Setup Guide Centos V1 related to IronPDF Linux Compatibility & Setup Guide

We recommend using .NET Core 3.1 and any other runtimes marked as LTS by Microsoft because they have guaranteed long-term support and are generally well tested on Linux.

No code changes are required to run IronPDF on Linux. Generally, IronPDF works out of the box thanks to hundreds of hours of testing and configuration by our engineers.

Linux support is important because many cloud services such as Azure Web Apps, Azure Functions, AWS EC2, AWS Lambda, Azure Devops, and Docker rely heavily on Linux. At Iron Software, we use these cloud tools regularly and understand that many of our Enterprise and SAAS customers do too.

Hardware Specification

IronPDF uses Chromium to render HTML to PDF. The Chromium engine renders PDFs with pixel-perfect accuracy similar to Chrome's print feature. The hardware specifications are primarily for running the Chromium engine, which takes most of the computing power.

  • Minimum: 1 Core & 1.75 GB of RAM
  • Recommended: 2 Cores & 8 GB of RAM or above

Officially Supported Linux Distros

We officially support and recommend the latest 64-bit Linux OS's below for "zero configuration" setup of IronPDF.

  • Ubuntu 22
  • Ubuntu 20
  • Ubuntu 18
  • Ubuntu 16
  • Debian 11 [Currently the Microsoft Azure Default Linux Distro]
  • Debian 10
  • CentOS 8
  • Fedora Linux 33
  • Amazon AWS Linux 2

Read the AWS Lambda Setup Guide for IronPdf.

Please read "Other Linux Distros" below for advice on installing IronPDF on a version of Linux which is not officially supported.

We recommend using Microsoft's Official Docker Images. Other Linux distros are supported in part but may require manual configuration using apt-get. See "Common Dependency Patterns for Linux" at the end of this document.

Linux Automatic Setup

The default setting LinuxAndDockerDependenciesAutoConfig true will automatically attempt to install all dependencies for IronPDF to run on Linux. The first HTML-to-PDF operation may take longer than usual.

// This setting ensures IronPDF automatically installs dependencies needed for Linux and Docker environments
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
// This setting ensures IronPDF automatically installs dependencies needed for Linux and Docker environments
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
' This setting ensures IronPDF automatically installs dependencies needed for Linux and Docker environments
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
$vbLabelText   $csharpLabel

Linux Optimized NuGet Packages

Install-Package IronPdf.Linux

There are NuGet Packages available for Linux optimized IronPDF deployments documented in our IronPDF advanced NuGet installation guide.

You can use this Linux optimized package and even develop on a Windows or macOS machine.

Alternatively, you can directly download the DLL for Linux.

Docker + Linux Setup

Please read our extensive documentation on using IronPDF on Docker if you need help setting up a Docker image that will use IronPDF.

Ubuntu Compatibility

Ubuntu is our most tested Linux operating system. This is because it is used heavily in the Azure infrastructure we use for continuous testing and deployment. This platform also has official Microsoft .NET support and Official Docker Images.

Ubuntu 20

Microsoft related to Ubuntu 20 Ubuntu V1 related to Ubuntu 20 Chrome V1 related to Ubuntu 20 Safari V1 related to Ubuntu 20 Docker related to Ubuntu 20 Azure 1 related to Ubuntu 20

We support Ubuntu 20 out of the box with zero configuration.

  • Support Chrome and WebKit based HTML to PDF rendering Engines
  • Officially support .NET Core 3.1, 5, 6 (LTS), 7 and 8 runtimes
  • Unofficially, we support many other .NET Core runtimes on Ubuntu 20
  • We run over 997 Unit tests on this platform before every release

Official Microsoft Docker Images:

Manual Ubuntu 20 Setup
If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence1 libgdiplus libva-dev

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL
  • IronCefSubprocess mentioned above is a binary within your application's bin folder. You may need to specify an exact path which may be in the runtimes subdirectory of bin.
  • You may need sudo privileges.

Ubuntu 18

Microsoft related to Ubuntu 18 Ubuntu V1 related to Ubuntu 18 Chrome V1 related to Ubuntu 18 Safari V1 related to Ubuntu 18 Docker related to Ubuntu 18 Azure 1 related to Ubuntu 18

We support Ubuntu 18 out of the box with zero configuration.

  • Support Chrome and WebKit based HTML to PDF rendering Engines
  • Official support .NET Core 3.1 LTS and .NET 5 runtimes
  • Unofficially, we support many other .NET Core runtimes on Ubuntu 18 and even 16
  • We run comprehensive smoke tests on this platform before every release

Official Microsoft Docker Images:

Manual Ubuntu 18 Setup
If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
apt update

# Install required packages
apt install -y libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence-dev

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
apt update

# Install required packages
apt install -y libc6 libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence-dev

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Ubuntu 16

Ubuntu V1 related to Ubuntu 16 Test related to Ubuntu 16

We have limited/unofficial support for Ubuntu 16. Ubuntu 16 has not been rigorously tested with IronPDF.

.NET on Ubuntu 16 is officially supported by Microsoft and is reported to work with IronPdf by many users. Developers may have to install apt-get dependencies manually.

  • Chrome and WebKit normally work with manual config.
  • .NET Core 3.1 LTS and .NET 5 runtimes have Microsoft support for Ubuntu 16.
  • There are currently no official Microsoft Docker images for Ubuntu 16.

Manual Ubuntu 16 Setup
If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence-dev

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence-dev

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Debian Compatibility

Debian is our second most tested Linux operating system. This platform also has official Microsoft .NET support and Official Docker Images.

Debian 11

Debian related to Debian 11 Microsoft related to Debian 11 Chrome V1 related to Debian 11 Safari V1 related to Debian 11 Docker related to Debian 11 Azure 1 related to Debian 11

Debian 11 is the default Linux distribution used by Microsoft when adding Docker support to a .NET project in Visual Studio.

We support Debian 11 out of the box with zero configuration.

  • Support Chrome and WebKit based HTML to PDF rendering Engines
  • Officially support .NET Core 3.1, 5, 6 (LTS), 7 and 8 runtimes
  • Unofficially, we support many other .NET Core runtimes on Debian 11
  • We run over 997 Unit tests on this platform before every release

Official Microsoft Docker Images:

Manual Debian 11 Setup
If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libxkbcommon-x11-0 libxrender1 libfontconfig1 libxshmfence1

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libxkbcommon-x11-0 libxrender1 libfontconfig1 libxshmfence1

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Debian 10

Debian related to Debian 10 Microsoft related to Debian 10 Chrome V1 related to Debian 10 Safari V1 related to Debian 10 Docker related to Debian 10 Azure 1 related to Debian 10

We support Debian 10 out of the box with zero configuration.

  • Support Chrome and WebKit based HTML to PDF rendering Engines
  • Officially support .NET Core 3.1, 5, 6 (LTS), 7 and 8 runtimes
  • Unofficially, we support many other .NET Core runtimes on Debian 10
  • We run over 997 Unit tests on this platform before every release

Official Microsoft Docker Images:

Manual Debian 10 Setup
If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence1

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence1

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Debian 9 and Lower

Debian related to Debian 9 and Lower Test related to Debian 9 and Lower

Debian 9 has not been officially tested and will not work out-of-the-box with IronPdf. However, .NET on Debian 9 is officially supported by Microsoft and can work with IronPdf if set up correctly (See "Common Dependency Patterns for Linux").

There are no official Docker images by Microsoft for .NET Core 3.1 or .NET 5.0 on Debian 9. We highly recommend migrating to Debian 10.

CentOS Compatibility

Centos related to CentOS Compatibility Chrome V1 related to CentOS Compatibility Safari V1 related to CentOS Compatibility Test related to CentOS Compatibility

We actively like and support CentOS.

CentOS 8 Support

We support CentOS 8 out of the box with zero configuration.

  • Support Chrome and WebKit based HTML to PDF rendering Engines
  • Officially support .NET Core 3.1, 5, 6 (LTS), 7 and 8 runtimes
  • Unofficially, we support many other .NET Core runtimes on CentOS
  • We run comprehensive smoke tests on this platform before every release

Sadly there are no official Docker images by Microsoft for .NET Core 3.1 or .NET 5.0 on CentOS 8.

Manual CentOS 8 Setup
If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
dnf -y update

# Install required packages
dnf -y install glibc-devel nss at-spi2-atk libXcomposite libXrandr mesa-libgbm alsa-lib pango cups-libs libXdamage libxshmfence

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
dnf -y update

# Install required packages
dnf -y install glibc-devel nss at-spi2-atk libXcomposite libXrandr mesa-libgbm alsa-lib pango cups-libs libXdamage libxshmfence

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

CentOS 7 and Lower

CentOS 7 has not been tested and will not work out-of-the-box with IronPdf.

However, .NET on CentOS 7 is officially supported by Microsoft and would likely work with IronPdf if set up correctly (please read "Common Dependency Patterns for Linux") below.

There are no official Docker images by Microsoft for .NET Core 3.1 or .NET 5.0 on CentOS 7.

Amazon AWS Linux 2 Compatibility

Amazon Web Services related to Amazon AWS Linux 2 Compatibility Chrome V1 related to Amazon AWS Linux 2 Compatibility Safari V1 related to Amazon AWS Linux 2 Compatibility Test related to Amazon AWS Linux 2 Compatibility

We have working support for Amazon AWS Linux 2, which forms the basis of Amazon's cloud services such as EC2 and Lambda.

  • There are no official Docker images by Microsoft for .NET Core 3.1 or .NET 5.0 on Amazon AWS Linux 2.
  • We manually test for Amazon AWS Linux 2 compatibility as we develop IronPDF

We recommend that you read our IronPDF AWS Lambda guide which contains a working Docker file for IronPdf on AWS Lambda.

Amazon Linux 2 Manual Setup

If you wish to manually install or your app cannot be run with sudo admin privileges:

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update package list
yum update -y

# Install required packages
yum install -y pango.x86_64 libXcomposite.x86_64 libXcursor.x86_64 libXdamage.x86_64 libXext.x86_64 libXi.x86_64 libXtst.x86_64 cups-libs.x86_64 libXScrnSaver.x86_64 libXrandr.x86_64 GConf2.x86_64 alsa-lib.x86_64 atk.x86_64 gtk3.x86_64 ipa-gothic-fonts xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-utils xorg-x11-fonts-cyrillic xorg-x11-fonts-Type1 xorg-x11-fonts-misc glibc-devel.x86_64 at-spi2-atk.x86_64 mesa-libgbm.x86_64 libxkbcommon

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
yum update -y

# Install required packages
yum install -y pango.x86_64 libXcomposite.x86_64 libXcursor.x86_64 libXdamage.x86_64 libXext.x86_64 libXi.x86_64 libXtst.x86_64 cups-libs.x86_64 libXScrnSaver.x86_64 libXrandr.x86_64 GConf2.x86_64 alsa-lib.x86_64 atk.x86_64 gtk3.x86_64 ipa-gothic-fonts xorg-x11-fonts-100dpi xorg-x11-fonts-75dpi xorg-x11-utils xorg-x11-fonts-cyrillic xorg-x11-fonts-Type1 xorg-x11-fonts-misc glibc-devel.x86_64 at-spi2-atk.x86_64 mesa-libgbm.x86_64 libxkbcommon

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Please also read our documentation on our official support IronPdf for AWS Lambda that includes installation and logging on the Amazon cloud platform.

Fedora Linux Compatibility

Fedora Linux is supported.

We support Fedora Linux 33 out of the box with zero configuration.

  • Support Chrome and WebKit based HTML to PDF rendering Engines
  • Officially support .NET Core 3.1, 5, 6 (LTS), 7 and 8 runtimes
  • We run comprehensive smoke tests on this platform before every release

Manual Fedora Linux Setup
If you wish to manually install or your app cannot be run with sudo admin privileges. This may also help with older or newer builds of Fedora Linux.

Set IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Install required packages
dnf -y install glibc-devel nss at-spi2-atk libXcomposite libXrandr mesa-libgbm alsa-lib pango cups-libs libXdamage libxshmfence

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Install required packages
dnf -y install glibc-devel nss at-spi2-atk libXcomposite libXrandr mesa-libgbm alsa-lib pango cups-libs libXdamage libxshmfence

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

Alpine Linux Compatibility

Running IronPDF on Alpine Linux is not supported. We wish we could but we can't. Frankly, we like Alpine and hope this project continues and grows. As of 2023, Alpine still uses outdated "musl" C language libraries that do not allow chromium developers to fully support this OS yet.

Using Alpine Docker with IronPdfEngine in .NET 6

IronPdf provides a container image containing all IronPdf functionalities. This enables projects running on Alpine to access IronPdf functionalities by connecting to the IronPdfEngine container.

Step 1: Pull and Run IronPdf Engine Docker Image

Execute the following commands in your terminal to pull and run the IronPdf Engine Docker image:

# Pull IronPdf Engine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdf Engine Docker image
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
# Pull IronPdf Engine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdf Engine Docker image
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine
SHELL

Step 2: Set Up Console App

Create a new console application targeting .NET 6.
Install the IronPdf.Slim NuGet package using the NuGet Package Manager.

Other Linux Distros

You can also manually install the IronPDF prerequisites for Linux using apt-get, hfs, and yum. This allows you to use IronPDF on many unsupported Linux distros.

Generally, during installation for the first time, IronPDF will throw exceptions to tell you of any necessary system dependencies.

  • IronCefSubprocess mentioned below is a binary within your application's bin folder. You may need to specify an exact path which may be in the runtimes subdirectory of bin.
  • You may need sudo privileges.

If you are uncertain how to proceed with an unlisted Linux OS, investigate the dependencies for the Chromium browser on that OS.

If you want to vote for official support for a different Linux distro, please contact support@ironsoftware.com with your request.

Common Dependency Patterns for Linux
Please also study the dependency packages for other Linux OS's above.

# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence1

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
# Update package list
apt update

# Install required packages
apt install -y libc6-dev libgtk2.0-0 libnss3 libatk-bridge2.0-0 libx11-xcb1 libxcb-dri3-0 libdrm-common libgbm1 libasound2 libappindicator3-1 libxrender1 libfontconfig1 libxshmfence1

# Make IronCefSubprocess executable
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/
SHELL

IronCefSubprocess

IronCefSubprocess is a binary file within your application's bin folder. It needs to be executable by the .NET process.

E.g. (path may vary)

# Make IronCefSubprocess executable
chmod 755 bin/runtimes/linux-64/IronCefSubprocess
# Make IronCefSubprocess executable
chmod 755 bin/runtimes/linux-64/IronCefSubprocess
SHELL

dotnet single-file publishing in Linux

If you choose to export your project as single-file publishing on Linux, this is how to do it:

# Publish as a single file for Linux
dotnet publish -r linux-x64 /property:PublishProfile=FolderProfile /bl
# Publish as a single file for Linux
dotnet publish -r linux-x64 /property:PublishProfile=FolderProfile /bl
SHELL

Temp File Paths

Developers may need to specify a writable directory where temporary files can be created for some use cases.

A common, safe value for this path is /tmp/ in Linux, but ultimately it must be a path where the user can read and write files.

// Set IronPDF temporary path to /tmp/
string tmpPath = @"/tmp/";

IronPdf.Logging.Logger.LogFilePath = tmpPath;
Environment.SetEnvironmentVariable("TEMP", tmpPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", tmpPath, EnvironmentVariableTarget.Process);
IronPdf.Installation.TempFolderPath = tmpPath;
IronPdf.Installation.CustomDeploymentDirectory = tmpPath;
// Set IronPDF temporary path to /tmp/
string tmpPath = @"/tmp/";

IronPdf.Logging.Logger.LogFilePath = tmpPath;
Environment.SetEnvironmentVariable("TEMP", tmpPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", tmpPath, EnvironmentVariableTarget.Process);
IronPdf.Installation.TempFolderPath = tmpPath;
IronPdf.Installation.CustomDeploymentDirectory = tmpPath;
' Set IronPDF temporary path to /tmp/
Dim tmpPath As String = "/tmp/"

IronPdf.Logging.Logger.LogFilePath = tmpPath
Environment.SetEnvironmentVariable("TEMP", tmpPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", tmpPath, EnvironmentVariableTarget.Process)
IronPdf.Installation.TempFolderPath = tmpPath
IronPdf.Installation.CustomDeploymentDirectory = tmpPath
$vbLabelText   $csharpLabel

Frequently Asked Questions

What versions of .NET are supported on Linux?

You can use IronPDF to support .NET 8, 7, 6, 5, and .NET Core applications on Linux.

What Linux distributions are officially supported?

IronPDF officially supports Ubuntu 22, 20, 18, 16, Debian 11, 10, CentOS 8, Fedora Linux 33, and Amazon AWS Linux 2.

Does it require any manual configuration on Linux?

No code changes are required to run IronPDF on Linux, and it generally works out of the box. However, some Linux distributions may require manual configuration using 'apt-get'.

How are dependencies handled on Linux?

IronPDF can automatically install all necessary dependencies on Linux using the 'LinuxAndDockerDependenciesAutoConfig' setting set to true.

Is it compatible with Docker on Linux?

Yes, IronPDF is compatible with Docker on Linux. There is extensive documentation available for setting up a Docker image that uses IronPDF.

What are the recommended hardware specifications for running on Linux?

The minimum hardware specification for running IronPDF is 1 core and 1.75 GB of RAM, while the recommended specification is 2 cores and 8 GB of RAM or above.

Can it be used on Alpine Linux?

IronPDF is not supported on Alpine Linux due to outdated 'musl' C language libraries. However, IronPdf functionalities can be accessed via a separate IronPdfEngine container for projects running on Alpine.

How can I install the Linux optimized package?

You can install the IronPDF Linux optimized package via NuGet using the command: 'Install-Package IronPdf.Linux'.

Is there support for older versions of CentOS and Debian?

IronPDF is not officially tested on CentOS 7 and Debian 9, but .NET support by Microsoft may allow IronPDF to work if set up correctly.

What should I do if I encounter issues with unsupported Linux distributions?

If you encounter issues with unsupported Linux distributions, you can manually install IronPDF prerequisites using apt-get, hfs, and yum, or contact support@ironsoftware.com for assistance.

Chaknith Bin
Software Engineer
Chaknith works on IronXL and IronBarcode. He has deep expertise in C# and .NET, helping improve the software and support customers. His insights from user interactions contribute to better products, documentation, and overall experience.