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
Does IronPDF support .NET Framework projects on macOS?
No, IronPDF does not support .NET Framework projects on macOS as they are implemented by Xamarin and are not an official release of the .NET runtime.
Which versions of .NET are supported by IronPDF on macOS?
IronPDF supports .NET Standard Libraries, Core applications, and .NET 9, 8, 7, 6, and 5 projects on macOS.
Are there any dependencies to install IronPDF on macOS?
There are no dependencies required to install IronPDF on macOS; however, it is recommended to install the Mac-specific package for optimal performance.
Which NuGet package should I install for Apple Silicon Macs?
For Apple Silicon Macs, you should install the IronPdf.MacOs.ARM NuGet package.
What is the recommended hardware specification for running IronPDF?
The recommended hardware specification for running IronPDF is 2 Cores and 8 GB of RAM or above.
Is multithreaded PDF rendering supported on macOS?
No, multithreaded PDF rendering is not currently supported on macOS due to the lack of a message pump built into the Chromium Embedded Framework for Mac.
Can developers deploy their projects to multiple environments using IronPDF?
Yes, developers can deploy their projects to Windows, Linux, and Mac environments, but they will need to add additional binaries based on the deployment environment.
How can I download IronPDF for offline usage?
For offline usage, you can download the IronPdf.MacOs.zip DLL and add a reference to your project.
What is IronPDF's connection to Chromium?
IronPDF uses the Chromium engine to render HTML to PDF, providing results that are pixel-perfect to Chrome's print feature.
