Using IronPDF on Mac
IronPDF fully supports macOS (formerly "OS X") for .NET Standard Libraries, Core applications, and .NET 9, 8, 7, 6 & 5 projects.
We do not support the development of .NET Framework projects on macOS as they are implemented by Xamarin, and are not an official release of the .NET runtime.
IronPDF has fully supported all versions of macOS out-of-the-box since 2020. There are no dependencies to install; however, we recommend installing the Mac-specific package for optimal performance.
Latest Mac ARM Machines:
For the newer Apple Silicon Macs, install the IronPdf.MacOs.ARM NuGet package.
dotnet add package IronPdf.MacOs.ARM
Older Mac Intel Machines:
For Intel Macs, install the IronPdf.MacOs NuGet package.
dotnet add package IronPdf.MacOs
Notes
No code changes are required to support Apple users or developers. Once developed on a Mac, developers can also deploy to Windows, Linux, and Mac environments. This will require the developers to add additional binaries depending on where the project is being deployed.
On macOS, the only difference is that multithreaded PDF rendering support (often important on web servers) cannot yet be supported due to the lack of a message pump built into the Chromium Embedded Framework for Mac.
We value support for macOS because many .NET developers, including members of our team, enjoy developing .NET applications on Visual Studio for Mac and JetBrains Rider on macOS.
macOS Specific Configuration & Install
NuGet
Apple has used various generations of Intel processors over the years, and since 2020, they have been launching Mac computers with Apple Silicon processors.
- For the newer Apple Silicon Macs, install the IronPdf.MacOs.ARM NuGet package.
- For Intel Macs, install the IronPdf.MacOs NuGet package.
- To support both Intel and Apple Silicon Macs, install both IronPdf.MacOs and IronPdf.MacOs.ARM NuGet packages.
DLL Download
For offline usage, you can download the DLL and add a reference to your project.
Hardware Specification
IronPDF uses Chromium to render HTML to PDF. The Chromium engine delivers results that are pixel-perfect to Chrome's print feature. The hardware specifications are primarily for running the Chromium engine, which demands most of the computing power.
- Minimum: 1 Core & 1.75 GB of RAM
- Recommended: 2 Cores & 8 GB of RAM or above
Frequently Asked Questions
How do I install IronPDF on macOS?
You can install IronPDF on macOS by using the appropriate NuGet package. For Apple Silicon Macs, use the IronPdf.MacOs.ARM
package, and for Intel Macs, use the IronPdf.MacOs
package. To support both architectures, install both packages.
What are the hardware requirements for running IronPDF on macOS?
The minimum hardware requirements for running IronPDF on macOS are 1 Core and 1.75 GB of RAM. However, for optimal performance, a configuration of 2 Cores and 8 GB of RAM or more is recommended.
Can I use IronPDF to render PDFs on macOS without additional dependencies?
Yes, IronPDF has supported all versions of macOS since 2020 without requiring additional dependencies. However, installing the Mac-specific package is recommended for optimal performance.
Why is multithreaded PDF rendering not supported on macOS?
Multithreaded PDF rendering is not supported on macOS due to the limitations in the Chromium Embedded Framework's message pump for macOS, which IronPDF relies upon for rendering.
Can I deploy IronPDF projects developed on macOS to other operating systems?
Yes, projects developed with IronPDF on macOS can be deployed to Windows, Linux, and Mac environments. Additional binaries may need to be added depending on the deployment environment.
How can I use IronPDF offline on macOS?
To use IronPDF offline on macOS, you can download the IronPdf.MacOs.zip
DLL and add a reference to your project.
What role does Chromium play in IronPDF's functionality on macOS?
IronPDF uses the Chromium engine to render HTML to PDF. This ensures that the generated PDFs are pixel-perfect, similar to what you would achieve using Chrome's print feature.
Is IronPDF compatible with .NET Framework projects on macOS?
No, IronPDF is not compatible with .NET Framework projects on macOS due to their implementation by Xamarin, which is not an official release of the .NET runtime.