1. IronPDF
  2. Comenzar
  3. Resumen de Instalación

Installation Overview

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Complete guide to installing and configuring IronPDF across all platforms.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer

1. Platform Requirements

Platform .NET Version Hardware Additional Requirements, Compatibility
Logo Table Windows related to 1. Platform Requirements
Windows 		.NET 10, 9, 8, 7, 6, 5, .NET Core, .NET Standard, and .NET Framework.
  • Minimum: 1 Core & 1.75 GB of RAM
  • Recommended: 2 Cores & 8 GB of RAM or above
  • Windows 10, 11, and Windows Server
  • Visual C++ Redistributable (x86 & x64)
Logo Table Linux related to 1. Platform Requirements
Linux
  • 64-bit Linux OSs: Ubuntu 22, Ubuntu 20, Ubuntu 18, Ubuntu 16, Debian 10-11m CentOS 8, Fedora Linux 33, Amazon, AWS, Linux 2
  • IronCefSubprocess
  • Chrome dependencies
Logo Table Mac related to 1. Platform Requirements
macOS 		All macOS versions since 2020

2. Installation Methods

There are two ways you can install IronPDF: native mode and remote engine. By default, native mode is recommended. For deploying to production servers using Docker/Kubernetes, use remote engine mode.

Remote Engine Mode Separate PDF processing via gRPC protocol.
  • Best for: Cloud and containerized deployments, legacy OS support.
  • Package: IronPdf.Slim
  • Size: More lightweight, taking up a few MB.
  • Requirements: Requires configuring the connection to host.
Native Mode (Default) Everything runs locally in your application
Float Recommended related to 2. Installation Methods
  • Best for: Modern Windows, macOS, and Linux deployments.
  • Package: Full IronPdf NuGet package.
  • Size: Larger in size (hundreds of MBs), including Chrome and Pdfium binaries.
  • Requirements: Works on modern operating systems.

3. Installation Options

Installing the C# PDF library takes less than 5 minutes. Get it free via NuGet or direct download and start using it in Visual Studio right away.

NuGet Package
Manual Download
Remote IronPdfEngine

Go to the IronPDF NuGet library (or Package Manager Console in Visual Studio)

  1. In Solution Explorer, right-click on References
  2. Select 'Manage NuGet Packages' > 'Browse' > Search IronPdf
  3. Select the package and install.
Install-Package IronPdf

RELATED: More advanced IronPDF Nuget packages

  1. Download IronPDF DLL package for your platform: Windows, Linux, macOS
  2. Unzip the ZIP file for your OS to a location within your Solution directory.
  3. In Visual Studio Solution Explorer, right-click on 'Dependencies.'
  4. 'Add Project Reference' > Select 'Browse' to include all the DLLs extracted from the zip.

Por favor notaPlease note: Each IronPDF release requires the matching version of IronPdfEngine. Cross-version support isn’t available. For example, IronPDF 2024.2.2 must use IronPdfEngine 2024.2.2.

Install IronPdf using NuGet.

Install-Package IronPdf.Slim

4. Additional Configurations

Manage License
Path & Permission
Remote Engine

After you’ve purchased or signed up for a 30-day trial of IronPDF, find the license key sent to your email.

Add your license key at the start of your application.

IronPdf.License.LicenseKey = "KEY";
IronPdf.License.LicenseKey = "KEY";
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Check license status.

bool valid = IronPdf.License.IsLicensed;
bool valid = IronPdf.License.IsLicensed;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

Set the TempFolderPath property of the IronPdf.Installation object.

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";
IronPdf.Installation.TempFolderPath = "C:\My\Safe\Path"
$vbLabelText   $csharpLabel

ConsejosMake sure to clear all temp and cache folders on your development and servers, then redeploy a clean version of your application after updating a path.

Setting the temp folder environment variable at application scope.

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");
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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ConsejosOn a locked down server, give the IIS user (IUSER) read and write permissions to your installation path folder, as well as to your Windows and Temp Folder.

[Remote IronPdfEngine] After installing the IronPdf.Slim package, connect to the engine container and configure the connection at app startup or before calling any IronPDF method.

Assuming IronPdfEngine runs remotely at 123.456.7.8:33350: 

Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

RELATED: IronPdfEngine Limitations

[Linux] Enable IronPDF to auto-install all required Linux dependencies. The first HTML-to-PDF operation may take longer than usual.

Installation.LinuxAndDockerDependenciesAutoConfig = true;
Installation.LinuxAndDockerDependenciesAutoConfig = true;
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

[Docker] Pre-initialize Chrome engine to preload prerequisites and speed up first-time use in Docker.

IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize();
IronPdf.Installation.Initialize()
$vbLabelText   $csharpLabel

RELATED: IronPDF Linux Docker Compatibility and Setup

5. Deployment Scenarios

Logo Azure related to 5. Deployment Scenarios

Run & Deploy IronPDF .NET on

Azure Function
Logo Aws related to 5. Deployment Scenarios

Run & Deploy IronPDF .NET on

AWS Lambda
Logo Linux related to 5. Deployment Scenarios

Run IronPDF in

Linux Docker Container
Logo Remote related to 5. Deployment Scenarios

Run IronPDF as a

Remote Container

Next Steps

Complete Guide on HTML to PDF C#

See Tutorial

Changelog: Updates, milestones, roadmap

See Product Updates

Request Engineering Support

See Troubleshooting

Quickstart Guide Native vs Remote Engine

Preguntas Frecuentes

¿Cómo puedo configurar IronPdfEngine para la generación remota de PDF?

Para configurar IronPdfEngine para la generación remota de PDF, instala el paquete IronPdf.Slim desde NuGet y configura las configuraciones de conexión usando la clase IronPdfConnectionConfiguration. Esta configuración te permite conectar tu aplicación a la instancia de IronPdfEngine remotamente.

¿Cuáles son los principales beneficios de usar IronPdfEngine con mi aplicación?

Usar IronPdfEngine con tu aplicación permite la ejecución remota de tareas PDF, ayudando a evitar problemas de compatibilidad específicos de la plataforma, especialmente en sistemas más antiguos y plataformas móviles. También elimina la necesidad del tiempo de ejecución de .NET durante la ejecución.

¿Por qué podría elegir usar IronPdfEngine en lugar de la biblioteca PDF nativa?

Podrías elegir IronPdfEngine para ejecutar funciones PDF intensivas en rendimiento de forma remota, reduciendo problemas de compatibilidad con diferentes sistemas operativos y mejorando el rendimiento al aprovechar un renderizador idéntico a Chrome para la conversión de HTML a PDF.

¿Es compatible el escalado horizontal en IronPdfEngine?

No, IronPdfEngine actualmente no admite el escalado horizontal, lo que significa que no puede ser equilibrado en carga entre múltiples instancias debido a la forma en que se manejan los archivos binarios de PDF en la memoria del servidor.

¿Puede ejecutarse IronPdfEngine en diferentes sistemas operativos?

IronPdfEngine está diseñado para ejecutarse en sistemas Linux usando contenedores Docker. Sin embargo, los archivos binarios son específicos de la plataforma, por lo que necesitas asegurarte de usar la versión correcta para tu sistema operativo.

¿Qué debo hacer si mis salidas de PDF son diferentes al usar IronPdfEngine?

Las salidas de PDF pueden variar ligeramente debido a comportamientos diferentes del sistema operativo. Para minimizar diferencias, asegúrate de estar usando la imagen Docker correcta y verifica cualquier configuración específica del sistema operativo que pueda afectar el renderizado.

¿Cómo aseguro que mi aplicación esté usando la versión correcta de IronPdfEngine?

Para asegurar la compatibilidad, cada versión de IronPDF requiere una versión correspondiente de IronPdfEngine. Asegúrate de actualizar ambos componentes simultáneamente para evitar problemas de versiones cruzadas.

¿Cuáles son las limitaciones al usar IronPdfEngine en Windows?

Al usar IronPdfEngine en Windows, necesitas contenedores de Linux para Docker y debes asegurarte de que el puerto del servidor sea accesible. Los binarios son específicos de la plataforma y se requiere cambiar a contenedores de Linux.

¿Cómo configuro IronPDF para conectar a un servidor remoto de IronPdfEngine?

Para configurar IronPDF para un servidor remoto, usa Installation.ConnectToIronPdfHost con el método IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer, especificando los detalles de IP y puerto del servidor.

¿Qué paquete debo usar para minimizar el tamaño de la aplicación al usar IronPdfEngine?

Deberías usar el paquete IronPdf.Slim de NuGet, ya que incluye solo los componentes necesarios para ejecutar IronPDF con IronPdfEngine, reduciendo así el tamaño de la aplicación.

Curtis Chau
Curtis Chau
  Chatea con el equipo de ingeniería ahora
Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

Leer más
¿Listo para empezar?
Nuget Descargas 16,133,208 | Versión: 2025.11 recién lanzado