---
type: Article
title: Install Marqius wkhtmltopdf with APT on Debian | Marqius
description: Install Marqius with APT on Debian 12 or 13. Keep your old
  wkhtmltopdf command while you check a PDF with Marqius.
resource: https://marqius.com/blog/install-marqius-with-apt/
tags:
  - marqius
  - journal
status: stable
sources:
  - id: official-page
    resource: https://marqius.com/blog/install-marqius-with-apt/
    last_modified: 2026-11-20T07:32:56.288Z
generated:
  by: process:marqius-site-build
  at: 2026-11-20T10:17:10.036Z
x_marqius:
  language: en
  source_sha256: b78a7363d2d9654cf21a4914632e1aaed5d670ebd58d661abb68b35359f4ba6a
  extraction: public-main-content
---

wkhtmltopdf migration

# Install Marqius wkhtmltopdf with APT on Debian

Install Marqius with APT on Debian 12 or 13. Keep your old wkhtmltopdf command while you check a PDF with Marqius.

Marqius November 20, 2026

Say your invoice app is moving to a new Debian server. You want it to keep making the same PDFs, and you want APT to manage the new PDF program the way it manages your other packages. You can install Marqius through its signed APT source on **Debian 12 or 13**, on **amd64 or arm64**.

## Why this helps

The package gives your app a clear path to the new program, `/usr/bin/marqius-wkhtmltopdf`. The old `wkhtmltopdf` command stays available. You can have one app try Marqius while other jobs keep using the old tool, and use APT to manage future updates or remove the package.

## 1\. Open a disposable Debian shell

You need Docker running. This example tests Trixie. Use `debian:bookworm-slim` in the same command if you want to try Debian 12.

Terminal

```
mkdir -p marqius-apt-demo
cd marqius-apt-demo
docker run --rm -it --mount "type=bind,source=$PWD,target=/proof" debian:trixie-slim bash
```

Run the remaining blocks inside that shell. You're already root in this container. To apply the package setup on a real Debian host, run the system changes as a user with sudo.

## 2\. Download and check the signing key

Terminal

```
apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends ca-certificates curl gpg poppler-utils
curl -fsSLo marqius-archive-keyring.gpg https://marqius.com/download/apt/marqius-archive-keyring.gpg
gpg --show-keys --with-fingerprint marqius-archive-keyring.gpg
```

Check for **BFF2 545B B544 3FDB 31CE 801B 421B 8E68 D7C2 2538** before continuing. APT uses this key to check the Marqius package list.

## 3\. Add the source and install the package

Terminal

```
install -d -m 0755 /etc/apt/keyrings
install -m 0644 marqius-archive-keyring.gpg /etc/apt/keyrings/marqius-archive-keyring.gpg
cat > /etc/apt/sources.list.d/marqius.sources <<'SOURCES'
Types: deb
URIs: https://marqius.com/download/apt/
Suites: stable
Components: main
Architectures: amd64 arm64
Signed-By: /etc/apt/keyrings/marqius-archive-keyring.gpg
SOURCES
apt-get update
apt-cache policy marqius-wkhtmltopdf
apt-get install -y marqius-wkhtmltopdf
marqius-wkhtmltopdf --version
```

You should see an available version and then the installed version. The package also installs DejaVu fonts. Your production PDFs may need the same fonts you used on the old server.

## 4\. Make and check a PDF

Terminal

```
cd /proof
```

The studio’s **Invoice 1001** uses three Marqius products as line items so you can see how they fit together. **Marqius wkhtmltopdf** keeps your existing PDF call working, **Studio** is where you design the document, and **Relay** generates it from a template and data. The sample amounts add up to **120.00 EUR** including VAT. Open `START-HERE.html` after unzipping to run the invoice and check a page break. [Download the print demo (ZIP)](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-invoice-demo.zip) · [Open the invoice PDF](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/expected-invoice.pdf)

If your team also checks files before they go to press, use the sample from Marqius Engine. It has a finished A4 size, 3 mm of bleed, real CMYK colour patches and a 100 mm reference you can measure at actual size. [Open the press test sheet](https://marqius.com/download/wkhtmltopdf-demo/0.12.8/marqius-press-proof.pdf)

Unzip the demo and put `invoice.html` in your test folder. If you're already in the terminal, you can get the same file with one command.

Terminal

```
curl -fsSLo invoice.html https://marqius.com/download/wkhtmltopdf-demo/0.12.8/invoice.html.txt
```

Terminal

```
marqius-wkhtmltopdf --page-size A4 invoice.html invoice-marqius.pdf
pdfinfo invoice-marqius.pdf | grep '^Pages:'
pdftotext invoice-marqius.pdf - | grep -F '120.00 EUR'
exit
```

Open **invoice-marqius.pdf** from the demo folder. If it has one page and reads **Total due: 120.00 EUR**, the converter made the file. In a test copy of your app, set your library's path to **/usr/bin/marqius-wkhtmltopdf** and repeat the test with an invoice your app actually sends. [Exact setting for each library](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard)

The disposable container goes away when you exit. If you installed on a test host and want to undo it, run `sudo apt-get remove marqius-wkhtmltopdf`. The old `wkhtmltopdf` command stays in place. [Trial and licensing](https://marqius.com/wkhtmltopdf-buy/)

## Reader questions

### Does apt install marqius-wkhtmltopdf replace the existing wkhtmltopdf command?

The package installs /usr/bin/marqius-wkhtmltopdf. It leaves the wkhtmltopdf command and the Debian package that owns it in place.

## 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/install-marqius-with-apt/

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