# Aperçu de l'installation
Guide complet pour l'installation et la configuration d'IronPDF sur toutes les plateformes.
```cs
:title=Get started making PDFs now!
IronPdf.ChromePdfRenderer
.StaticRenderHtmlAsPdf("<p>Hello World</p>")
.SaveAs("pixelperfect.pdf");
```
<hr />
## 1. Exigences de la plateforme
<table class="classic-table hover-cell">
<thead>
<tr>
<th><span>Plate-forme</span></th>
<th><span>Version .NET</span></th>
<th><span>Matériel</span></th>
<th><span>Exigences supplémentaires, compatibilité</span></th>
</tr>
</thead>
<tbody>
<tr>
<td>
<div class="d-flex align-items-center justify-content-center">
<img src="/static-assets/svgs/logo-table_windows.svg" width="64" height="64" alt="" />
</div>
<a href="/get-started/windows/">Windows</a>
</td>
<td rowspan="3"><span>.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard et .NET Framework.</span></td>
<td rowspan="3">
<ul>
<li>Configuration minimale : 1 cœur et 1,75 Go de RAM</li>
<li>Configuration recommandée : 2 cœurs et 8 Go de RAM ou plus</li>
</ul>
</td>
<td>
<ul>
<li>Windows 10, 11 et Windows Server</li>
<li>Visual C++ Redistributable (x86 et x64)</li>
</ul>
</td>
</tr>
<tr>
<td>
<div class="d-flex align-items-center justify-content-center">
<img src="/static-assets/svgs/logo-table_linux.svg" width="64" height="64" alt="" />
</div>
<a href="/get-started/linux/">Linux</a>
</td>
<td>
<ul>
<li>OS Linux 64 bits : Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11, CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2</li>
<li>IronCefSubprocess</li>
<li>Dépendances de Chrome</li>
</ul>
</td>
</tr>
<tr>
<td>
<div class="d-flex align-items-center justify-content-center">
<img src="/static-assets/svgs/logo-table_mac.svg" width="64" height="64" alt="" />
</div>
<a href="/get-started/macos/">macOS</a>
</td>
<td><span>Toutes les versions de macOS depuis 2020</span></td>
</tr>
</tbody>
</table>
<hr />
## 2. Méthodes d'installation
Il y a deux façons d'installer IronPDF : mode natif et moteur distant. Par défaut, le mode natif est recommandé. Pour le déploiement sur des serveurs de production utilisant Docker/Kubernetes, utilisez le mode moteur distant.
<div class="row install-modes g-3">
<div class="col-6">
<div class="install-mode">
<div class="install-mode__header">
<span class="install-mode__title">Mode moteur à distance</span>
<span class="install-mode__subtitle">Traitement séparé des PDF via le protocole gRPC.</span>
</div>
<div class="install-mode__body">
<ul>
<li><strong>Idéal pour :</strong> les déploiements dans le cloud et les conteneurs, la prise en charge des systèmes d'exploitation anciens.</li>
<li><strong>Paquet :</strong> IronPdf.Slim</li>
<li><strong>Taille :</strong> Plus léger, occupant quelques mégaoctets. </li>
<li><strong>Exigences :</strong> Nécessite la configuration de la connexion à l'hôte.</li>
</ul>
</div>
</div>
</div>
<div class="col-6">
<div class="install-mode install-mode--recommended">
<div class="install-mode__header">
<span class="install-mode__title">Mode natif (par défaut)</span>
<span class="install-mode__subtitle">Tout s'exécute localement dans votre application.</span>
<div class="recommended-float">
<img src="/static-assets/svgs/float-recommended.svg" width="151" height="37.8" alt="" />
</div>
</div>
<div class="install-mode__body">
<ul>
<li><strong>Idéal pour :</strong> les déploiements modernes sous Windows, macOS et Linux.</li>
<li><strong>Paquet :</strong> Paquet NuGet IronPDF complet.</li>
<li><strong>Taille :</strong> Plus grande (plusieurs centaines de Mo), incluant les binaires Chrome et Pdfium.</li>
<li><strong>Exigences :</strong> Fonctionne sur les systèmes d'exploitation modernes.</li>
</ul>
</div>
</div>
</div>
</div>
<hr />
## 3. Options d'installation
L'installation de la bibliothèque C# PDF prend moins de 5 minutes. Obtenez-le gratuitement via NuGet ou téléchargement direct et commencez à l'utiliser dans Visual Studio immédiatement.
<div class="installation-options__container" data-active-tab="1">
<div class="installation-options__tabs">
<div class="installation-options__tab" data-tab="1">
<span>Package NuGet</span>
</div>
<div class="installation-options__tab" data-tab="2">
<span>Téléchargement manuel</span>
</div>
<div class="installation-options__tab" data-tab="3">
<span>Moteur IronPDF à distance</span>
</div>
</div>
<div class="installation-options__info" data-tab="1"></div>
<div class="installation-options__info" data-tab="2"></div>
<div class="installation-options__info" data-tab="3"></div>
</div>
<div id="nuget-package-start"></div>
Allez à la [bibliothèque NuGet IronPDF](https://www.nuget.org/packages/IronPdf/) (ou console de gestion de paquets dans Visual Studio)
1. Dans l'Explorateur de solutions, faites un clic droit sur Références
2. Sélectionnez 'Gérer les paquets NuGet' > 'Parcourir' > Rechercher IronPDF
3. Sélectionnez le paquet et installez-le.
```shell
:ProductInstall
```
<p class="related-link">**À LIRE AUSSI :** <a href="/get-started/advanced-installation-nuget/">Packages NuGet IronPDF plus avancés<i class="fa-solid fa-arrow-right"></i></a></p>
<div id="nuget-package-end"></div>
<div id="manual-download-start"></div>
<ol>
<li>Téléchargez le package DLL IronPDF pour votre plateforme : Windows, Linux, macOS</li>
<li>Décompressez le fichier ZIP correspondant à votre système d'exploitation dans un emplacement situé dans votre répertoire de solution.</li>
<li>Dans l'explorateur de solutions de Visual Studio, cliquez avec le bouton droit sur " Dépendances ".</li>
<li>ajouter une référence de projet" > Sélectionnez "Parcourir" pour inclure toutes les DLL extraites du fichier zip.</li>
</ol>
<div id="manual-download-end"></div>
<div id="remote-ironpdfengine-start"></div>
[[i:(Veuillez noter : chaque version IronPDF nécessite la version correspondante d'IronPDFEngine. La compatibilité entre les versions n'est pas disponible. Par exemple, IronPDF 2024.2.2 doit utiliser IronPDFEngine 2024.2.2.)]]
Installez IronPDF en utilisant NuGet.
```shell
:InstallCmd Install-Package IronPdf.Slim
```
<div id="remote-ironpdfengine-end"></div>
## 4. Configurations supplémentaires
<div class="installation-options__container" data-active-tab="1">
<div class="installation-options__tabs">
<div class="installation-options__tab" data-tab="1">
<span>Gérer les licences</span>
</div>
<div class="installation-options__tab" data-tab="2">
<span>Path & Permission</span>
</div>
<div class="installation-options__tab" data-tab="3">
<span>Moteur à distance</span>
</div>
</div>
<div class="additional-configurations__info" data-tab="1"></div>
<div class="additional-configurations__info" data-tab="2"></div>
<div class="additional-configurations__info" data-tab="3"></div>
</div>
<div id="manage-license-start"></div>
Après avoir acheté ou vous être inscrit à une version d'essai de 30 jours d'IronPDF, retrouvez la clé de licence envoyée à votre email.
Ajoutez votre clé de licence au début de votre application.
```csharp
IronPdf.License.LicenseKey = "KEY";
```
Vérifiez l'état de la licence.
```csharp
bool valid = IronPdf.License.IsLicensed;
```
<div id="manage-license-end"></div>
<div id="path-permission-start"></div>
Définissez la propriété TempFolderPath de l'objet IronPdf.Installation.
```csharp
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
```
[[t:(Assurez-vous de supprimer tous les dossiers temporaires et de cache sur vos environnements de développement et serveurs, puis redéployez une version propre de votre application après avoir mis à jour le chemin d'accès.)]]
Définir la variable d'environnement du dossier temporaire au niveau de l'application.
```csharp
using IronPdf;
// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);
// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");
// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
```
Sur un serveur sécurisé, accordez à l'utilisateur IIS (IUSER) les autorisations de lecture et d'écriture sur le dossier d'installation, ainsi que sur les dossiers Windows et Temp.
<div id="path-permission-end"></div>
<div id="remote-engine-start"></div>
**[IronPDFEngine à distance]** Après avoir installé le package IronPdf.Slim, connectez-vous au conteneur du moteur et configurez la connexion au démarrage de l'application ou avant d'appeler n'importe quelle méthode IronPDF.
En supposant que l'IronPDFEngine fonctionne à distance à 123.456.7.8:33350 :
```csharp
Installation.ConnectToIronPdfHost(
IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
```
<p class="related-link">**À LIRE AUSSI :** <a href="/get-started/ironpdfengine/#ironpdfengine-limitations">Limitations d'IronPDFEngine<i class="fa-solid fa-arrow-right"></i></a></p>
**[Linux]** Activer IronPDF pour installer automatiquement toutes les dépendances Linux requises. La première opération HTML-PDF peut prendre plus de temps que d'habitude.
```csharp
Installation.LinuxAndDockerDependenciesAutoConfig = true;
```
**[Docker]** Pré-initialiser le moteur Chrome pour précharger les prérequis et accélérer la première utilisation dans Docker.
```csharp
IronPdf.Installation.Initialize();
```
<p class="related-link">**RELATED:** <a href="/get-started/linux/">Compatibilité et configuration d'IronPDF Linux Docker <i class="fa-solid fa-arrow-right"></i></a></p>
<div id="remote-engine-end"></div>
<hr />
## 5. Scénarios de déploiement
<div class="row deployment-scenarios g-4">
<div class="col-6">
<div class="deployment-card">
<div class="deployment-card__icon">
<img src="/static-assets/svgs/logo-azure.svg" width="64" height="64" alt="" />
</div>
<div class="deployment-card__info">
<p class="deployment-card__title">Exécuter et déployer IronPDF .NET sur</p>
<a href="/get-started/azure/" class="deployment-card__link">Fonction Azure <i class="fa-solid fa-arrow-right"></i></a>
</div>
</div>
</div>
<div class="col-6">
<div class="deployment-card">
<div class="deployment-card__icon">
<img src="/static-assets/svgs/logo-aws.svg" width="64" height="64" alt="" />
</div>
<div class="deployment-card__info">
<p class="deployment-card__title">Exécuter et déployer IronPDF .NET sur</p>
<a href="/get-started/aws/" class="deployment-card__link">AWS Lambda <i class="fa-solid fa-arrow-right"></i></a>
</div>
</div>
</div>
<div class="col-6">
<div class="deployment-card">
<div class="deployment-card__icon">
<img src="/static-assets/svgs/logo-linux.svg" width="64" height="64" alt="" />
</div>
<div class="deployment-card__info">
<p class="deployment-card__title">Exécutez IronPDF dans</p>
<a href="/get-started/ironpdf-docker/" class="deployment-card__link">Conteneur Docker Linux <i class="fa-solid fa-arrow-right"></i></a>
</div>
</div>
</div>
<div class="col-6">
<div class="deployment-card">
<div class="deployment-card__icon">
<img src="/static-assets/svgs/logo-remote.svg" width="64" height="64" alt="" />
</div>
<div class="deployment-card__info">
<p class="deployment-card__title">Exécutez IronPDF en tant que</p>
<a href="/get-started/ironpdfengine-docker/" class="deployment-card__link">Conteneur distant <i class="fa-solid fa-arrow-right"></i></a>
</div>
</div>
</div>
</div>
<hr />
## Prochaines étapes
<div class="row g-3">
<div class="col-12 col-md-6 col-xxl-4">
<a href="/tutorials/html-to-pdf/" class="next-step__card">
<div class="next-step__card-info">
<div class="next-step__card-icon">
<i class="fa-duotone fa-solid fa-graduation-cap"></i>
</div>
<span class="next-step__card-text">Guide complet sur la conversion HTML en PDF avec C#</span>
</div>
<p class="next-step__card-cta">Voir le tutoriel<i class="fa-solid fa-arrow-right"></i></p>
</a>
</div>
<div class="col-12 col-md-6 col-xxl-4">
<a href="/product-updates/changelog/" class="next-step__card">
<div class="next-step__card-info">
<div class="next-step__card-icon">
<i class="fa-solid fa-clock-rotate-left"></i>
</div>
<span class="next-step__card-text">Journal des modifications : mises à jour, étapes clés, feuille de route</span>
</div>
<p class="next-step__card-cta">Consultez les mises à jour du produit<i class="fa-solid fa-arrow-right"></i></p>
</a>
</div>
<div class="col-12 col-md-6 col-xxl-4">
<a href="/troubleshooting/engineering-request-pdf/" class="next-step__card">
<div class="next-step__card-info">
<div class="next-step__card-icon">
<i class="fa-duotone fa-solid fa-wrench"></i>
</div>
<span class="next-step__card-text">Demande d'assistance technique</span>
</div>
<p class="next-step__card-cta">Consultez la section Dépannage<i class="fa-solid fa-arrow-right"></i></p>
</a>
</div>
</div>
<hr />
<div class="tutorials-navigation">
<a href="/get-started/quickstart/" class="tutorials-navigation__cta tutorials-navigation__cta--left"><i class="fa-solid fa-chevron-left"></i>Quickstart Guide</a>
<a href="/get-started/ironpdfengine/" class="tutorials-navigation__cta tutorials-navigation__cta--right">Native vs Remote Engine<i class="fa-solid fa-chevron-right"></i></a>
</div>
Il y a deux façons d'installer IronPDF : mode natif et moteur distant. Par défaut, le mode natif est recommandé. Pour le déploiement sur des serveurs de production utilisant Docker/Kubernetes, utilisez le mode moteur distant.
Mode moteur à distanceTraitement séparé des PDF via le protocole gRPC.
Idéal pour : les déploiements dans le cloud et les conteneurs, la prise en charge des systèmes d'exploitation anciens.
Paquet : IronPdf.Slim
Taille : Plus léger, occupant quelques mégaoctets.
Exigences : Nécessite la configuration de la connexion à l'hôte.
Mode natif (par défaut)Tout s'exécute localement dans votre application.
Idéal pour : les déploiements modernes sous Windows, macOS et Linux.
Paquet : Paquet NuGet IronPDF complet.
Taille : Plus grande (plusieurs centaines de Mo), incluant les binaires Chrome et Pdfium.
Exigences : Fonctionne sur les systèmes d'exploitation modernes.
3. Options d'installation
L'installation de la bibliothèque C# PDF prend moins de 5 minutes. Obtenez-le gratuitement via NuGet ou téléchargement direct et commencez à l'utiliser dans Visual Studio immédiatement.
Téléchargez le package DLL IronPDF pour votre plateforme : Windows, Linux, macOS
Décompressez le fichier ZIP correspondant à votre système d'exploitation dans un emplacement situé dans votre répertoire de solution.
Dans l'explorateur de solutions de Visual Studio, cliquez avec le bouton droit sur " Dépendances ".
ajouter une référence de projet" > Sélectionnez "Parcourir" pour inclure toutes les DLL extraites du fichier zip.
Veuillez noter: Veuillez noter : chaque version IronPDF nécessite la version correspondante d'IronPDFEngine. La compatibilité entre les versions n'est pas disponible. Par exemple, IronPDF 2024.2.2 doit utiliser IronPDFEngine 2024.2.2.
Installez IronPDF en utilisant NuGet.
PM > Install-Package IronPdf.Slim
Install-Package IronPdf.Slim
4. Configurations supplémentaires
Gérer les licences
Path & Permission
Moteur à distance
Après avoir acheté ou vous être inscrit à une version d'essai de 30 jours d'IronPDF, retrouvez la clé de licence envoyée à votre email.
Ajoutez votre clé de licence au début de votre application.
Conseils: Assurez-vous de supprimer tous les dossiers temporaires et de cache sur vos environnements de développement et serveurs, puis redéployez une version propre de votre application après avoir mis à jour le chemin d'accès.
Définir la variable d'environnement du dossier temporaire au niveau de l'application.
using IronPdf;// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the applicationvarMyTempPath = @"C:\Safe\Path\";Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);// Set IronPDF Temp PathIronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");// Your PDF Generation and editing codevarRenderer = new IronPdf.ChromePdfRenderer();using varDoc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");Doc.SaveAs("example.pdf");
using IronPdf;
// Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);
// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");
// Your PDF Generation and editing code
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
ImportsIronPdf' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the applicationDimMyTempPathAsString = "C:\Safe\Path\"Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)' Set IronPDF Temp PathIronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")' Your PDF Generation and editing codeDimRendererAs New IronPdf.ChromePdfRenderer()UsingDoc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")Doc.SaveAs("example.pdf")EndUsing
Imports IronPdf
' Adjusts System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the application
Dim MyTempPath As String = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)
' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")
' Your PDF Generation and editing code
Dim Renderer As New IronPdf.ChromePdfRenderer()
Using Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
End Using
Sur un serveur sécurisé, accordez à l'utilisateur IIS (IUSER) les autorisations de lecture et d'écriture sur le dossier d'installation, ainsi que sur les dossiers Windows et Temp.
[IronPDFEngine à distance] Après avoir installé le package IronPdf.Slim, connectez-vous au conteneur du moteur et configurez la connexion au démarrage de l'application ou avant d'appeler n'importe quelle méthode IronPDF.
En supposant que l'IronPDFEngine fonctionne à distance à 123.456.7.8:33350 :
[Linux] Activer IronPDF pour installer automatiquement toutes les dépendances Linux requises. La première opération HTML-PDF peut prendre plus de temps que d'habitude.
Comment puis-je configurer IronPDFEngine pour la génération de PDF à distance ?
Pour configurer IronPDFEngine pour la génération de PDF à distance, installez le package IronPdf.Slim depuis NuGet et configurez les paramètres de connexion en utilisant la classe IronPDFConnectionConfiguration. Cette configuration vous permet de connecter votre application à l'instance IronPDFEngine à distance.
Quels sont les principaux avantages de l'utilisation d'IronPDFEngine avec mon application ?
L'utilisation d'IronPDFEngine avec votre application permet l'exécution à distance de tâches PDF, aidant à éviter les problèmes de compatibilité spécifiques à la plateforme, surtout sur d'anciens systèmes et plateformes mobiles. Elle élimine également le besoin du runtime .NET pendant l'exécution.
Pourquoi pourrais-je choisir d'utiliser IronPDFEngine au lieu de la bibliothèque PDF native ?
Vous pourriez choisir IronPDFEngine pour exécuter des fonctions PDF intensives en performance à distance, réduisant les problèmes de compatibilité avec différents systèmes d'exploitation et améliorant les performances en utilisant un moteur identique à Chrome pour la conversion HTML en PDF.
Le scaling horizontal est-il pris en charge par IronPDFEngine ?
Non, IronPDFEngine ne prend actuellement pas en charge le scaling horizontal, ce qui signifie qu'il ne peut pas être équilibré en charge sur plusieurs instances en raison de la façon dont les binaires de fichiers PDF sont gérés en mémoire serveur.
IronPDFEngine peut-il fonctionner sur différents systèmes d'exploitation ?
IronPDFEngine est conçu pour fonctionner sur des systèmes Linux en utilisant des conteneurs Docker. Cependant, les binaires sont spécifiques à chaque plateforme, vous devez donc vous assurer d'utiliser la version correcte pour votre système d'exploitation.
Que dois-je faire si mes sorties PDF sont différentes lorsque j'utilise IronPDFEngine ?
Les sorties PDF peuvent varier légèrement en raison des comportements différents du système d'exploitation. Pour minimiser les différences, assurez-vous d'utiliser l'image Docker correcte et vérifiez les configurations spécifiques à l'OS pouvant affecter le rendu.
Comment puis-je m'assurer que mon application utilise la bonne version d'IronPDFEngine ?
Pour assurer la compatibilité, chaque version de IronPDF nécessite une version correspondante d'IronPDFEngine. Assurez-vous de mettre à jour les deux composants simultanément pour éviter les problèmes de version croisée.
Quelles sont les limitations de l'utilisation d'IronPDFEngine sur Windows ?
Lors de l'utilisation d'IronPDFEngine sur Windows, vous avez besoin des conteneurs Linux pour Docker et devez vous assurer que le port serveur est accessible. Les binaires sont spécifiques à la plateforme, et passer aux conteneurs Linux est requis.
Comment puis-je configurer IronPDF pour se connecter à un serveur IronPDFEngine distant ?
Pour configurer IronPDF pour un serveur distant, utilisez Installation.ConnectTo IronPDFHost avec la méthode IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer, en spécifiant l'IP et les détails du port du serveur.
Quel package devrais-je utiliser pour minimiser la taille de l'application lors de l'utilisation d'IronPDFEngine ?
Vous devriez utiliser le package IronPdf.Slim depuis NuGet, car il inclut seulement les composants nécessaires pour exécuter IronPDF avec IronPDFEngine, réduisant ainsi la taille de l'application.
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.