---
type: Article
title: Migrate Rotativa.AspNetCore off wkhtmltopdf | Marqius
description: Keep ViewAsPdf and your existing view. Put Marqius in the folder
  where Rotativa looks.
resource: https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/
tags:
  - marqius
  - journal
status: stable
sources:
  - id: official-page
    resource: https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/
    last_modified: 2026-11-20T07:06:22.466Z
generated:
  by: process:marqius-site-build
  at: 2026-11-20T10:17:10.036Z
x_marqius:
  language: en
  source_sha256: 78f5c2b8410a42b34d43c81f4937c3f6bb268c30c4518f503681015246a3e930
  extraction: public-main-content
---

wkhtmltopdf migration

# Migrate Rotativa.AspNetCore off wkhtmltopdf

Keep ViewAsPdf and your existing view. Put Marqius in the folder where Rotativa looks.

Marqius November 20, 2026

An ASP.NET Core app returns invoices with Rotativa. The controller still has the order details, but its publish folder is missing the program Rotativa looks for.

**Marqius is a drop-in replacement for wkhtmltopdf.** Your app can keep using Rotativa.AspNetCore to ask for a PDF.

## Why this helps

Keep the controller and view. Put Marqius where Rotativa already looks for the wkhtmltopdf file, then check one invoice through the actual web route.

## Make your first PDF

Start with **Invoice 1001** for **120.00 EUR**. Open the example PDF to see what this library’s test should produce. The kit includes all 14 sample projects and a more detailed print demo for checking tables and page breaks. Open `START-HERE.html` after unzipping. [Download the library starter kit (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip) · [Open the library example PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-wrapper-invoice.pdf)

With Docker running, unzip the demo to a fresh folder and open a terminal in the folder containing `examples/`. You can also start in an empty folder. The command in step 3 will fetch the files for you inside the container.

### 1\. Open a fresh test container

Terminal

```
docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" mcr.microsoft.com/dotnet/sdk:10.0 bash
```

Run the rest of the steps in the shell that just opened. The container is a fresh Linux test environment. Your host folder is mounted as `/proof`, so you can open the saved PDF after the test.

### 2\. Install the tools and Marqius

Terminal

```
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl unzip fonts-dejavu-core poppler-utils
mkdir -p /work
cd /work
curl -fsSLo install-marqius.sh https://marqius.com/marqius-wkhtmltopdf.sh
bash install-marqius.sh --version 0.12.8 --prefix /work/bin
export PATH="/work/bin:$PATH"
export WKHTMLTOPDF_BINARY=/work/bin/marqius-wkhtmltopdf
"$WKHTMLTOPDF_BINARY" --version
wkhtmltopdf --version
```

The version output should include **marqius-wkhtmltopdf 0.12.8**. Marqius supplies the `wkhtmltopdf` command inside this test container.

### 3\. Bring the demo project into the test container

Terminal

```
cd /work
if [ -d /proof/examples/rotativa-aspnetcore ]; then
  cp -R /proof/examples .
else
  curl -fsSLo wrapper-demos.zip https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-wrapper-demos.zip &&
    unzip -oq wrapper-demos.zip
fi
```

### 4\. Put Marqius where Rotativa looks and build the app

Terminal

```
cd examples/rotativa-aspnetcore
mkdir -p wwwroot/Rotativa
install -m 0755 "$WKHTMLTOPDF_BINARY" wwwroot/Rotativa/wkhtmltopdf
dotnet build --configuration Release
```

### 5\. Call the invoice route and stop the test app

Terminal

```
ASPNETCORE_URLS=http://127.0.0.1:5043 dotnet run --no-build --configuration Release > /proof/server.log 2>&1 &
server_pid=$!
curl -fsS --retry 20 --retry-connrefused --retry-delay 1 --max-time 5 http://127.0.0.1:5043/invoice -o /proof/invoice.pdf
kill "$server_pid"
```

### 6\. Check that the PDF contains the right invoice

Terminal

```
pdfinfo /proof/invoice.pdf | grep '^Pages:'
pdftotext /proof/invoice.pdf - | grep -F 'Invoice 1001'
pdftotext /proof/invoice.pdf - | grep -F '120.00'
chmod a+r /proof/invoice.pdf
```

Look for one page, the invoice number and the amount. Type `exit` to close the test container. Open `invoice.pdf` in the folder you created on your computer.

## How to switch your own app to Marqius

Keep ViewAsPdf and supply Marqius under the wkhtmltopdf filename in the directory RotativaConfiguration.Setup selects. This guide covers Rotativa.AspNetCore on Linux.

Use the Linux download for the CPU architecture of your deployed container. If using the APT package, copy its executable into the directory Rotativa expects under the name `wkhtmltopdf` as part of the application build. [Debian installation guide](https://marqius.com/blog/install-wkhtmltopdf-debian/) · [Downloads for other environments](https://marqius.com/wkhtmltopdf/download/)

Apply the change in Program.cs and your publish or container build. This setup expects the executable under the configured web root's Rotativa directory.. Retain the existing rendering options unless your comparison identifies a reason to change them.

csharp

```
Rotativa.AspNetCore.RotativaConfiguration.Setup(app.Environment.WebRootPath, "Rotativa");
```

## Try it with a document you know

During deployment, put the Marqius Linux binary at `wwwroot/Rotativa/wkhtmltopdf` and give it execute permission. Prevent requests from serving that directory as static files. If you already use another directory, retain that one and confirm the resolved path in staging. Check that the publish artifact includes the binary.

Render the real MVC action in staging and inspect margins, repeated table headings and the footer. Direct libwkhtmltox bindings such as DinkToPdf have a different integration and cannot use this setup line.

## Check the old and new PDFs

Save a PDF from the old setup. Make it again with the same data and fonts. Check the words, amounts and page breaks. Keep the old program path handy so you can switch back if you need to. The [runnable Rotativa.AspNetCore example](https://github.com/marqius-wkhtmltopdf/marqius-wkhtmltopdf-examples/tree/a76beedb20845e2ebec0c73741cee70d7142385a/examples/rotativa-aspnetcore/) exercises a sample PDF through the wrapper. The [developer manual chapter](https://marqius.com/download/developer-manual.pdf#page=44) records the test conditions and constraints. The [public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard) reports differences for the wkhtmltopdf and Marqius renderers.

[All 14 library guides](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Elixir pdf\_generator](https://marqius.com/blog/migrate-elixir-pdf-generator/) · [go-wkhtmltopdf](https://marqius.com/blog/migrate-go-wkhtmltopdf/) · [Try Marqius for 30 days](https://marqius.com/wkhtmltopdf-buy/)

## Reader questions

### Does RotativaConfiguration.Setup take the executable path?

In this example it selects a directory under the web root. Rotativa looks for the wkhtmltopdf filename inside that directory. Verify the resolved path for your installed version.

## Keep reading

[wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie](https://marqius.com/blog/install-wkhtmltopdf-debian/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [All journal guides](https://marqius.com/blog/)

Source for this page [^official-page].

[^official-page]: https://marqius.com/blog/migrate-rotativa-off-wkhtmltopdf/

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