Using IronPDF on Linux

Distributions Linux officiellement prises en charge

Nous soutenons officiellement et recommandons les derniers systèmes d'exploitation Linux 64 bits ci-dessous pour une configuration "zéro configuration" de IronPDF.

• Ubuntu 22
• Ubuntu 20
• Ubuntu 18
• Ubuntu 16
• Debian 11
• Debian 10
• CentOS 8
• Fedora Linux 33
• Amazon AWS Linux 2

Si vous installez IronPDF sur une version Linux non prise en charge, consultez les modèles de dépendance communs pour Linux à la fin de ce document.

Configuration automatique sous Linux

Le paramètre par défaut LinuxAndDockerDependenciesAutoConfig défini sur true tentera d'installer automatiquement toutes les dépendances pour faire fonctionner IronPDF sur Linux. La première opération HTML-PDF peut prendre plus de temps que d'habitude.

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;

' Enables automatic configuration of dependencies for Linux
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True

Ubuntu 20

Nous prenons en charge Ubuntu 20 avec une configuration zéro.

• Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
• Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
• Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Ubuntu 20
• Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Images Docker officielles de Microsoft :

• Image Docker 64 bits Ubuntu 20.04 pour .NET Runtime 3.1 ('3.1-focal')
• Image Docker 64 bits Ubuntu 20.04 pour .NET Runtime 5.0 ('5.0-focal')

Configuration manuelle d'Ubuntu 20

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo. Définissez la propriété IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig sur false et installez les dépendances manuellement.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1
apt install -y libgdiplus
apt install -y libva-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Ubuntu 18

Nous prenons en charge Ubuntu 18 dès la sortie du carton avec une configuration zéro.

• Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
• Support officiel .NET Core 3.1 LTS et les environnements d'exécution .NET 5
• Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Ubuntu 18 et 16
• Effectuez des tests de fumée complets sur cette plateforme avant chaque version

Images Docker officielles de Microsoft :

• Image Docker 64 bits Ubuntu 18.04 pour .NET Runtime 3.1 ('3.1-bionic')
• Bien qu'il n'y ait pas d'image docker officielle pour .NET 5 sur Ubuntu 18, la compatibilité est très élevée.

Configuration manuelle d'Ubuntu 18

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo. Définissez la propriété IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig sur false et installez les dépendances manuellement.

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Ubuntu 16

Nous disposons d'un support limité pour Ubuntu 16. .NET sur Ubuntu 16 est officiellement soutenu par Microsoft et est rapporté fonctionner avec IronPdf par de nombreux utilisateurs. Les développeurs peuvent avoir besoin d'installer des dépendances supplémentaires manuellement.

• Chrome et WebKit fonctionnent généralement avec une configuration manuelle.
• Les environnements d'exécution .NET Core 3.1 LTS et .NET 5 ont le support de Microsoft pour Ubuntu 16.
• Il n'y a actuellement aucune image Docker officielle de Microsoft pour Ubuntu 16.

Configuration manuelle d'Ubuntu 16

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo. Définissez la propriété IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig sur false et installez les dépendances manuellement.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence-dev

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Debian 11

Nous prenons en charge Debian 11 dès la sortie du carton avec une configuration zéro.

• Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
• Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
• Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Debian 11
• Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Images Docker officielles de Microsoft :

• Image Docker 64 bits Debian 11 pour .NET Runtime 3.1
• Image Docker 64 bits Debian 11 pour .NET Runtime 5.0

Configuration manuelle de Debian 11

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo. Définissez la propriété IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig sur false et installez les dépendances manuellement.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libxkbcommon-x11-0
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Debian 10

Nous prenons en charge Debian 10 dès la sortie du carton avec une configuration zéro.

• Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
• Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
• Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur Debian 10
• Effectuez plus de 997 tests unitaires sur cette plateforme avant chaque version

Images Docker officielles de Microsoft :

• Image Docker 64 bits Debian 10 pour .NET Runtime 3.1
• Image Docker 64 bits Debian 10 pour .NET Runtime 5.0

Configuration manuelle de Debian 10

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo. Définissez la propriété IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig sur false et installez les dépendances manuellement.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Debian 9 et inférieur

Debian 9 n'est pas officiellement testé et ne fonctionnera pas immédiatement avec IronPdf. Cependant, .NET sur Debian 9 est officiellement supporté par Microsoft et peut fonctionner avec IronPdf s'il est correctement configuré. Consultez les modèles de dépendance communs pour Linux à la fin de ce document.

Il n'existe aucune image Docker officielle de Microsoft pour .NET Core 3.1 ou .NET 5.0 sur Debian 9. Nous recommandons fortement de migrer vers Debian 10.

Support de CentOS 8

Nous prenons en charge CentOS 8 dès la sortie du carton avec une configuration zéro.

• Prise en charge de Chrome et de moteurs de rendu HTML en PDF basés sur WebKit
• Prise en charge officielle des environnements d'exécution .NET Core 3.1, 5, 6 (LTS), 7, et 8
• Prise en charge non officielle de nombreux autres environnements d'exécution .NET Core sur CentOS
• Effectuez des tests de fumée complets sur cette plateforme avant chaque version

Malheureusement, il n'y a pas d'images Docker officielles de Microsoft pour .NET Core 3.1 ou .NET 5.0 sur CentOS 8.

Configuration manuelle de CentOS 8

Si une installation manuelle est nécessaire ou si votre application ne peut pas être exécutée avec des privilèges admin sudo :

Définissez IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
dnf -y update
dnf -y install glibc-devel
dnf -y install nss
dnf -y install at-spi2-atk
dnf -y install libXcomposite
dnf -y install libXrandr
dnf -y install mesa-libgbm
dnf -y install alsa-lib
dnf -y install pango
dnf -y install cups-libs
dnf -y install libXdamage
dnf -y install libxshmfence

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

CentOS 7 et inférieur

CentOS 7 n'a pas été testé et ne fonctionnera pas immédiatement avec IronPdf.

Cependant, .NET sur CentOS 7 est officiellement supporté par Microsoft et fonctionnerait probablement avec IronPdf s'il est correctement configuré. Veuillez lire les modèles de dépendance communs pour Linux ci-dessous.

Il n'y a pas d'images Docker officielles de Microsoft pour .NET Core 3.1 ou .NET 5.0 sur CentOS 7.

Utilisation de Docker Alpine avec IronPdfEngine dans .NET 6

IronPdf fournit une image de conteneur contenant toutes les fonctionnalités de IronPdf. Cela permet aux projets fonctionnant sur Alpine d'accéder aux fonctionnalités de IronPdf en se connectant au conteneur IronPdfEngine.

Étape 1 : Extraire et exécuter l'image Docker de IronPdf Engine

Exécutez les commandes suivantes dans votre terminal pour extraire et exécuter l'image Docker de IronPdf Engine:

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

# Pull the IronPdfEngine Docker image
docker pull ironsoftwareofficial/ironpdfengine

# Run the IronPdfEngine container
docker run -d -p 33350:33350 ironsoftwareofficial/ironpdfengine

Étape 2 : Configurer l'application Console

• Créez une nouvelle application console ciblant .NET 6.
• Installez le package NuGet IronPdf.Slim en utilisant le gestionnaire de packages NuGet.

En savoir plus sur comment utiliser IronPdfEngine.

Modèles de dépendance communs pour Linux

Veuillez vous référer aux packages de dépendance pour d'autres systèmes d'exploitation Linux ci-dessus.

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

# Update and install necessary libraries
apt update
apt install -y libc6-dev
apt install -y libgtk2.0-0
apt install -y libnss3
apt install -y libatk-bridge2.0-0
apt install -y libx11-xcb1
apt install -y libxcb-dri3-0
apt install -y libdrm-common
apt install -y libgbm1
apt install -y libasound2
apt install -y libappindicator3-1
apt install -y libxrender1
apt install -y libfontconfig1
apt install -y libxshmfence1

# Change permissions for IronCefSubprocess
chmod 755 IronCefSubprocess
# Note: IronCefSubprocess is normally found at bin/runtimes/linux-x64/

Identifier les dépendances manquantes

ldd est un outil puissant pour diagnostiquer les dépendances manquantes. En exécutant ldd IronInterop.so, vous pouvez voir la liste de toutes les bibliothèques partagées requises par une application. Un message "not found" à côté d'une bibliothèque, comme libcef.so => not found, indique une dépendance critique manquante qui empêchera le programme de fonctionner correctement. Le fichier IronInterop.so se trouve dans le dossier natif du système d'exploitation spécifique. Par exemple, bin/Debug/net6.0/runtimes/linux-x64/native.

ldd IronInterop.so

ldd IronInterop.so

IronCefSubprocess

IronCefSubprocess est un fichier binaire dans le dossier bin de votre application. Il doit être exécutable par le processus .NET.

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess

# Change permissions for IronCefSubprocess
chmod 755 bin/runtimes/linux-64/IronCefSubprocess