---
type: Article
title: "Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie | Marqius"
description: Bookworm still has wkhtmltopdf. Trixie removed it. Find out why
  your install stopped and how Marqius can keep your PDF app working.
resource: https://marqius.com/blog/install-wkhtmltopdf-debian/
tags:
  - marqius
  - journal
status: stable
sources:
  - id: official-page
    resource: https://marqius.com/blog/install-wkhtmltopdf-debian/
    last_modified: 2026-11-20T07:33:07.701Z
generated:
  by: process:marqius-site-build
  at: 2026-11-20T10:17:10.036Z
x_marqius:
  language: en
  source_sha256: e360e202551778caa41b6e687ed3f30550ddca10d1b1ead5af505a5f655d4121
  extraction: public-main-content
---

wkhtmltopdf migration

# Install wkhtmltopdf on Debian 12 or 13: Bookworm and Trixie

Bookworm still has wkhtmltopdf. Trixie removed it. Find out why your install stopped and how Marqius can keep your PDF app working.

Marqius November 20, 2026

Say your Docker build worked last week. This week, the same line, `apt install wkhtmltopdf`, says it can’t find the package. Check whether the new image runs **Debian 12 Bookworm** or **Debian 13 Trixie**. Bookworm still has the package. Trixie removed it. [Bookworm package](https://packages.debian.org/bookworm/wkhtmltopdf) · [Debian removal discussion](https://bugs.debian.org/1091821)

## Why this helps

You can tell whether you have a missing command or a missing package before changing anything. If your app already makes invoices through a wkhtmltopdf library, Marqius gives it a new PDF program to call. You can keep the invoice code and get your new server or Docker image working.

## 1\. Open the Debian version you want to test

With Docker running, use a fresh folder. This opens Debian 13 Trixie. To see the Bookworm behavior, use **debian:bookworm-slim** instead.

Terminal

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

## 2\. Check the release and package

Run the following inside the container or the Debian server that makes the PDFs. Refresh the APT lists first in a new container.

Terminal

```
apt-get update
. /etc/os-release
printf '%s\n' "$PRETTY_NAME"
dpkg --print-architecture
command -v wkhtmltopdf || true
apt-cache policy wkhtmltopdf
```

**Command not found** means the program name does not resolve. **Unable to locate package** means your package lists have no match. Bookworm should show a package candidate. Trixie removed it, so updating the lists there will not bring it back. On Bookworm, you can install the original distro package with the following commands if you need it for a test:

Terminal

```
apt-get install -y wkhtmltopdf
wkhtmltopdf --version
```

Debian’s build lacks some features of the upstream patched-Qt build. If your app already makes good PDFs, save one from your current app before you change its server. [Debian package notes](https://packages.debian.org/bookworm/wkhtmltopdf)

## 3\. Install Marqius beside the old program

Use this on Bookworm or Trixie. The installer checks the download before setting up the executable. For package management instead, use the [signed APT guide](https://marqius.com/blog/install-marqius-with-apt/).

Terminal

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

The last line should show **marqius-wkhtmltopdf 0.12.8**. The old command is untouched.

## 4\. Make your first invoice PDF

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

```
"$WKHTMLTOPDF_BINARY" --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** on your computer and check the total. Set the absolute path where your actual PDF job runs. A program installed on your host will not appear inside your app container, so include it when you build that image. [Find the setting for your library](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) · [Public comparison scoreboard](https://github.com/marqiushq/wkhtmltopdf-parity#the-scoreboard)

## Reader questions

### Can I fix Unable to locate package wkhtmltopdf on Trixie with apt update?

Refreshing package lists helps when they are stale. Trixie removed wkhtmltopdf from its archive, so updating those lists will not restore it. Choose a replacement or use a separate Bookworm environment for the migration baseline.

## Keep reading

[wkhtmltopdf is unmaintained: Your options in 2026](https://marqius.com/blog/wkhtmltopdf-deprecated-alternatives/) [wkhtmltopdf vs headless Chromium: What changes when you switch](https://marqius.com/blog/wkhtmltopdf-vs-headless-chromium/) [wkhtmltopdf vs Gotenberg: When a PDF API makes sense](https://marqius.com/blog/wkhtmltopdf-vs-gotenberg/) [All journal guides](https://marqius.com/blog/)

Source for this page [^official-page].

[^official-page]: https://marqius.com/blog/install-wkhtmltopdf-debian/

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