.NET · ROTATIVA · ASP.NET CORE

Keep Rotativa.
Replace wkhtmltopdf.

Rotativa starts a wkhtmltopdf program from your application folder. Put the Linux Marqius build there under the same name and keep your ViewAsPdf actions.

curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash
wkhtmltopdf (current)Marqius (drop-in)
Illustrative pair of matching sample invoices
A simple, drop-in migration Keep your .NET workflow Install in minutes Compare your own PDFs
1

Install

Install the compatible program alongside your current wkhtmltopdf.

curl -fsSL https://marqius.com/marqius-wkhtmltopdf.sh | bash
2

Rotativa.AspNetCore

On Linux, place the installed program in the folder configured for Rotativa and make it executable.

cp /usr/local/bin/marqius wwwroot/Rotativa/wkhtmltopdf
chmod +x wwwroot/Rotativa/wkhtmltopdf
3

Compare output

Render a representative document and check the PDF before switching production.

marqius wkhtmltopdf invoice.html new.pdf
marqius compare old.pdf new.pdf
PRACTICAL DETAILS

What to check before you switch.

Wkhtmltopdf.NetCore

Put the compatible executable in the folder named in your registration.

builder.Services.AddWkhtmltopdf("wkhtmltopdf");

Libraries that load libwkhtmltox

DinkToPdf and WkHtmlToPdf-DotNet load a native library rather than running wkhtmltopdf. This executable cannot replace that library. Windows builds also remain in testing.

Marqius is proprietary software from Simple AI LLC. It is independent of the wkhtmltopdf project. Other product names identify the tools discussed in these guides.
QUESTIONS & ANSWERS

.NET questions

Does Rotativa work on Windows App Service?

The current compatible executable release is for Linux and Apple silicon macOS. Windows support is still being tested; use a Linux host for the current Rotativa path.

Can DinkToPdf use this executable?

No. DinkToPdf loads libwkhtmltox directly instead of starting wkhtmltopdf, so it needs a separate library integration.

Do Razor views and headers change?

Rotativa can keep the same Razor views and command-line options. Test headers, footers and page breaks on your actual documents.

Can I use it on Azure or AWS?

Use a supported Linux runtime, put the executable where the application expects it, install the required fonts and verify a PDF in that environment.