rposborne / wkhtmltopdf-heroku

wkhtmltopdf binary for heroku / amd64
MIT License
222 stars 92 forks source link

wkhtmltopdf-heroku

Provides a wkhtmltopdf binary for Heroku 22/24 Stacks.

Preconfigures pdfkit, wicked_pdf, and wisepdf to use this binary if they are loaded.

Installation

In your Gemfile:

For Heroku-22 Stack and Heroku-24 Stack

gem 'wkhtmltopdf-heroku', '3.0.0'

(Legacy) For Heroku Stack 18/20 (Ubuntu 18.04/20.04 LTS)

gem 'wkhtmltopdf-heroku', '2.12.6.0'

Usage

When using with wicked_pdf

Since wicked_pdf overwrites its config hash in the initializer, you will need to update it to make sure its exe_path is configured correctly.

If you don't need any extra configurations, you can simply remove the initializer. Or you can change it to:

WickedPdf.config ||= {}
WickedPdf.config.merge!({
  # your extra configurations here
})

When using with pdf_kit or wisepdf

No extra configuration is needed. But please make sure you are not re-configuring the binary path again in their initializer files.

When using with other gems

You will need to configure the path manually. You can get the path to the executable by using this: Gem.bin_path('wkhtmltopdf-heroku', 'wkhtmltopdf-linux-amd64')

Current wkhtmltopdf version

0.12.6.1 r2 Ubuntu Jammy AMD64

For more details see CHANGELOG

Supported Heroku Stacks

Contributors

Copyright

Copyright (c) 2011 Brad Phelan. See LICENSE.txt for further details.