---
type: WebPage
title: Rotativa wkhtmltopdf replacement for .NET | Marqius
description: On Linux, replace the wkhtmltopdf executable used by Rotativa or
  Wkhtmltopdf.NetCore. Keep your views and compare output; DinkToPdf needs a
  separate library.
resource: https://marqius.com/wkhtmltopdf/dotnet/
tags:
  - marqius
  - products-and-guides
status: stable
sources:
  - id: official-page
    resource: https://marqius.com/wkhtmltopdf/dotnet/
generated:
  by: process:marqius-site-build
  at: 2026-11-20T10:17:10.036Z
x_marqius:
  language: en
  source_sha256: e0926a74608806bd02ce6fdf59e4ac3cfe77a0fc4651ee2f84fd75390f433b6a
  extraction: public-main-content
---

.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
```

[Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial) [Download switching manual](https://marqius.com/download/replace-wkhtmltopdf.pdf)

wkhtmltopdf (current) Marqius (drop-in)

**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
```

**Switching manual**

Examples and troubleshooting for .NET and related stacks.

[Download the manual (PDF)](https://marqius.com/download/replace-wkhtmltopdf.pdf)[Developer manual (PDF)](https://marqius.com/download/developer-manual.pdf)[Getting started guide (PDF)](https://marqius.com/download/getting-started.pdf)[14 integration examples on GitHub](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples)

[Start your 30-day trial](https://marqius.com/app/sign-in/?plan=trial)

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.

Source for this page [^official-page].

[^official-page]: https://marqius.com/wkhtmltopdf/dotnet/

[Browse this section](index.md) · [Knowledge index](../index.md)
