IronPDF Advanced Installation

As of IronPDF Release v2022.1 and above, users have some advanced tools to install IronPDF for specific platforms.

Instead of installing the IronPDF NuGet Package, we can search NuGet for other IronPDF packages specific to our use case. The API remains the same, but they deploy differently.

Interestingly, even if we load a specific package such as IronPdf.Linux for a Linux-optimized deployment, you can still develop for it on your normal OS such as Windows with Visual Studio!

IronPdf NuGet Package

Nuget related to IronPdf NuGet Package Linux V1 related to IronPdf NuGet Package Docker related to IronPdf NuGet Package Azure 1 related to IronPdf NuGet Package Amazon Web Services related to IronPdf NuGet Package Ubuntu V1 related to IronPdf NuGet Package Mac Client related to IronPdf NuGet Package Windows Logo related to IronPdf NuGet Package

Most commonly used. Configured to get you up and running in Visual Studio as quickly as possible. Suitable for most projects.

PM > Install-Package IronPdf

  • Contains IronPdf.Slim
  • Contains Windows-specific dependencies for Chrome (default) renderer
  • Default package which will download Windows-specific dependencies at runtime
  • Defaults to Chrome renderer
  • Supports ALL platforms, but Windows platform will work without any additional downloads
  • Useful for Windows users or default users
  • OK TO USE ON ALL PLATFORMS

IronPdf.Slim NuGet Package

Cloud Backup Restore related to IronPdf.Slim NuGet Package Azure 1 related to IronPdf.Slim NuGet Package Nuget related to IronPdf.Slim NuGet Package

Ideal for the smallest disk footprint or applications which may be distributed to many different operating system targets. The precise Chromium / WebKit rendering engine for your application will be downloaded on demand at runtime on the target machine.

PM > Install-Package IronPdf.Slim

  • ALL other packages reference this package
  • Contains the actual IronPdf.dll
  • Does NOT include Windows, Linux, or macOS specific dependencies
  • Windows, Linux, or macOS dependencies will be downloaded at run-time
  • Defaults to Chrome renderer on all platforms unless otherwise specified
  • Useful for cross-platform solutions which want to download platform-specific dependencies at run-time
  • Supports ALL platforms, but platform-specific dependencies will be downloaded the first time the program is run
  • Requires internet access and disk access at runtime if used stand-alone.
  • Requires the installation of the IronSoftware.Native.PdfModel package.
  • Useful for highly portable applications where the target platform is unknown

IronPdf.Linux NuGet Package

Linux V1 related to IronPdf.Linux NuGet Package Debian related to IronPdf.Linux NuGet Package Ubuntu related to IronPdf.Linux NuGet Package Centos related to IronPdf.Linux NuGet Package Nuget related to IronPdf.Linux NuGet Package Azure 1 related to IronPdf.Linux NuGet Package Amazon Web Services related to IronPdf.Linux NuGet Package Docker related to IronPdf.Linux NuGet Package

Ideal for Deploying IronPdf on Linux. Designed with the cloud in mind. Works very well for AWS & Lambda, Azure Functions and WebApps in Linux mode.

PM > Install-Package IronPdf.Linux

  • Contains IronPdf.Slim
  • Contains Linux-specific dependencies for Chrome (default) renderer
  • Defaults to Chrome renderer
  • Supports ALL platforms, but Linux platform will work without any additional downloads
  • Useful for Linux power-users, specifically docker and cloud users

IronPdf.MacOs & IronPdf.MacOs.ARM NuGet Packages

Mac Client related to IronPdf.MacOs & IronPdf.MacOs.ARM NuGet Packages Nuget related to IronPdf.MacOs & IronPdf.MacOs.ARM NuGet Packages

NuGet Packages available for specific deployments for IronPdf Compatibility on macOS

PM > Install-Package IronPdf.MacOs

PM > Install-Package IronPdf.MacOs.ARM

  • Contains IronPdf.Slim
  • Contains Mac-specific dependencies for Chrome (default) renderer
  • Defaults to Chrome renderer
  • Useful for macOS developers

IronPdf.UpdatedChrome NuGet Package

Windows 11 related to IronPdf.UpdatedChrome NuGet Package Chrome related to IronPdf.UpdatedChrome NuGet Package

Users who want to use the latest compatible version of Chromium should install the following package. These are especially useful for those who need support for the most recent Chromium updates.

Please noteAvailability and updates are subject to change and announcements.

PM > Install-Package IronPdf.UpdatedChrome

  • contains IronPdf.Slim
  • contains IronSoftware.Native.Model
  • contains IronPdf.Native.UpdatedChrome.Windows
  • New settings and security updates.
  • May have a compatibility issues.
  • SingleProcess is not available.
  • Windows Server 2012 is not supported.
  • 32-bit processes are no longer supported.

IronPdf.UpdatedChrome.Linux NuGet Package

Linux V1 related to IronPdf.UpdatedChrome.Linux NuGet Package Chrome related to IronPdf.UpdatedChrome.Linux NuGet Package

Users who want to use the latest compatible version of Chromium should install the following package. These are especially useful for those who need support for the most recent Chromium updates.

Please noteAvailability and updates are subject to change and announcements.

PM > Install-Package IronPdf.UpdatedChrome.Linux

  • contains IronPdf.Slim
  • contains IronSoftware.Native.Model
  • contains IronPdf.Native.UpdatedChrome.Linux
  • New settings and security updates.
  • May have a compatibility issues.
  • SingleProcess is not available.
  • 32-bit processes are no longer supported.

IronPdf.UpdatedChrome.MacOs & IronPdf.UpdatedChrome.MacOs.ARM NuGet Package

Mac Client related to IronPdf.UpdatedChrome.MacOs & IronPdf.UpdatedChrome.MacOs.ARM NuGet Package Chrome related to IronPdf.UpdatedChrome.MacOs & IronPdf.UpdatedChrome.MacOs.ARM NuGet Package

Users who want to use the latest compatible version of Chromium should install the following packages. These are especially useful for those who need support for the most recent Chromium updates.

Please noteAvailability and updates are subject to change and announcements.

PM > Install-Package IronPdf.UpdatedChrome.MacOs

PM > Install-Package IronPdf.UpdatedChrome.MacOs.ARM

  • contains IronPdf.Slim
  • contains IronSoftware.Native.Model
  • contains IronPdf.Native.UpdatedChrome.MacOS or contains IronPdf.Native.UpdatedChrome.MacOS.ARM
  • New settings and security updates.
  • May have a compatibility issues.
  • SingleProcess is not available.
  • 32-bit processes are no longer supported.

IronPdf.Classic NuGet Package

Time Machine V1 related to IronPdf.Classic NuGet Package Linux V1 related to IronPdf.Classic NuGet Package Mac Client related to IronPdf.Classic NuGet Package Windows Logo related to IronPdf.Classic NuGet Package Nuget related to IronPdf.Classic NuGet Package

Useful for Legacy customers using IronPDF before August 2021 who wish their existing HtmlToPdf rendering to go unchanged. Uses our 2020-2021 WebKit renderer.

PM > Install-Package IronPdf.Classic

  • Contains IronPdf.Slim and IronPdf.Native.WebKit.
  • Contains Windows, Linux, and Mac dependencies for the (legacy) WebKit "HTML to PDF" renderer
  • Will use legacy WebKit renderer by default

If you would like to use the newer version of Chromium, please refer to the following troubleshooting article: IronPdf.Native.UpdatedChrome.

Frequently Asked Questions

How can I choose the right NuGet package for my operating system?

IronPDF offers specialized NuGet packages tailored for different operating systems: IronPdf for general use, IronPdf.Slim for minimal disk footprint, IronPdf.Linux for Linux environments, and IronPdf.MacOs/MacOs.ARM for macOS. Choose based on your deployment needs.

What are the advantages of using the IronPdf.Slim package?

The IronPdf.Slim package is designed for applications requiring a small disk footprint. It supports all platforms and downloads platform-specific dependencies at runtime, making it suitable for cross-platform applications that need to remain lightweight.

Is it possible to deploy IronPDF on cloud platforms like AWS and Azure?

Yes, the IronPdf.Linux package is optimized for cloud deployments on platforms like AWS and Azure. It includes Linux-specific dependencies for efficient functionality in cloud environments, supporting both AWS and Azure Functions.

How do macOS users benefit from the IronPdf.MacOs packages?

MacOS users can use the IronPdf.MacOs and IronPdf.MacOs.ARM packages, which are tailored for macOS deployments. These packages include Mac-specific dependencies and support ARM architecture, ensuring seamless integration and performance on macOS.

Can I use the legacy IronPdf.Classic package for my existing projects?

Yes, the IronPdf.Classic package is designed for customers who need to maintain their existing HTML to PDF rendering with the legacy WebKit renderer. It's especially useful for projects that began before August 2021 and require consistent performance.

Are IronPDF packages suitable for cross-platform development?

Absolutely. IronPDF packages, particularly IronPdf.Slim and IronPdf.Linux, are designed to support cross-platform development. They ensure compatibility across different operating systems while providing efficient performance tailored to each environment.

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.