---
type: WebPage
title: "wicked_pdf without wkhtmltopdf: a Rails migration | Marqius"
description: Keep Rails views, wicked_pdf and PDFKit calls. Change the
  executable path to Marqius and compare a representative PDF before switching.
resource: https://marqius.com/wkhtmltopdf/rails-ruby/
tags:
  - marqius
  - products-and-guides
status: stable
sources:
  - id: official-page
    resource: https://marqius.com/wkhtmltopdf/rails-ruby/
generated:
  by: process:marqius-site-build
  at: 2026-11-20T10:17:10.036Z
x_marqius:
  language: en
  source_sha256: 7ccfffa741d9bcc5edad12606b5a225bd255d2f8cbef445cd70a60e0870abe0e
  extraction: public-main-content
---

RUBY · RAILS · WICKED\_PDF · PDFKIT

# Keep wicked\_pdf.  
_Replace wkhtmltopdf._

Keep your render pdf calls and views. Give wicked\_pdf or PDFKit the new executable path, then compare a representative PDF.

```
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 Ruby & Rails 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

### wicked\_pdf

If your Gemfile includes wkhtmltopdf-binary, remove it before setting the new executable path.

```
WickedPdf.config = { exe_path: "/usr/local/bin/wkhtmltopdf" }

render pdf: "invoice", template: "invoices/show", layout: "pdf"
```

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 Ruby & Rails 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.

### PDFKit

```
PDFKit.configure { |config| config.wkhtmltopdf = "/usr/local/bin/wkhtmltopdf" }
```

### Check your pages

Exercise headers, footers, tables of contents and longer text. Compare the rendered pages before you switch a production job.

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

## Ruby & Rails questions

### Do wicked\_pdf helpers and Rails views still work?

The helpers prepare HTML in Rails. Keep them and configure wicked\_pdf to run the installed wkhtmltopdf-compatible executable, then compare the PDF.

### What about the wkhtmltopdf-binary gem?

If the gem supplies the old executable, remove or stop using it and set exe\_path to the Marqius-compatible program you installed.

### Can I keep a table of contents?

Test a document that uses your current toc options, links and page numbers. Review the complete PDF before switching.

### What if wicked\_pdf reports a bad executable path?

Set exe\_path to the installed program, confirm the process can execute it, and try a small Rails view.

Source for this page [^official-page].

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

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