SECURITY · UNTRUSTED HTML

Review your
wkhtmltopdf exposure.

The wkhtmltopdf maintainer warns against converting HTML you do not trust. Protect the converter now, then test the move to a maintained engine.

Printed documents on a desk
HTMLuntrusted input
Isolation boundaryConverterMarqius
PDFchecked output
A new converter still needs isolation when it fetches URLs or receives HTML from others.

Five safeguards to review.

Restrict local files

Allow only the files conversion needs.

Sanitize input

Clean or filter HTML from untrusted sources.

Limit JavaScript

Disable it when a document does not need it.

Isolate network access

Limit what the converter can reach.

Plan the migration

Compare real PDFs and keep a fallback.

REAL-WORLD CHECK

Check one real document.

Install Marqius, render your HTML, and compare its PDF with your current tool.

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

What to check before you switch.

What the project says

The maintainer’s status page says Qt 4 is unsupported, its WebKit has not been updated since 2012, and untrusted HTML can compromise the server. Read the original advice before making a migration decision.

wkhtmltopdf project statusArchived project repository

Five controls to review

  • Keep local file access off unless one folder is explicitly allowed.
  • Escape or sanitize values inserted into your HTML.
  • Disable JavaScript when the document does not need it.
  • Run conversion away from internal services and metadata endpoints.
  • Review your exit path from the archived engine.

Where Marqius fits

Marqius is maintained and does not embed the 2012 browser engine. A replacement converter still needs isolation when it fetches URLs or receives HTML from other users.

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

Security questions

Should I convert HTML supplied by other users without isolation?

No. The wkhtmltopdf maintainer warns against untrusted HTML. Sanitize input and restrict filesystem and network access before conversion.

Does moving to Marqius remove every conversion risk?

No. Any converter that reads files or fetches URLs needs appropriate isolation and resource limits.

What safeguards should I review first?

Restrict local files, sanitize untrusted HTML, disable unnecessary JavaScript, limit outbound network access and compare real PDFs before migration.

Where is the original project warning?

The wkhtmltopdf maintainer explains the risks and recommendations on the project status page at wkhtmltopdf.org/status.