heroku-buildpack-vips

by brandoncc

GitHub Readme.md

heroku-buildpack-vips

Disclaimer

If you don't need the vips binary, and you also don't need the latest version of vips, you might not need this buildpack. Take a look here at the versions that are now included in the Heroku stacks by default.

There are some known security issues with using outdated versions, see this issue comment for more information.

Important changes

The brief usage of pdfium that started August 2023 ended September 17, 2023. The buildpack is using poppler again due to #41 (comment).

As of heroku-20 and heroku-22, the following packages are already installed and don't need to be installed using an Aptfile:

  • libglib2.0-0
  • libglib2.0-dev

Found out more information like this in the changelog.

About this buildpack

A VIPS buildpack for the modern Heroku stacks. This stack supports the following stacks:

  • heroku-20
  • heroku-22

If you have problems on any of these stacks, or if a new stack comes out that is unsupported, please file an issue.

If you would like to use a build for a deprecated stack, the last versions which supported deprecated stacks are tagged with the stack name.

Important notes:

This buildpack started out as one of the many that are out there, and ended up being completely different. The build script uses docker and also includes pdf support via poppler.

Additionally, if you are planning to use sharp, you may also need the following packages:

  • libheif-dev
  • libfftw3-dev
  • libwebp-dev

The easiest way to do this is using the heroku apt buildpack.

This buildpack was put together with the help of John Cupitt, the creator of libvips. He was invaluable in my efforts to get a working libvips installation with pdf support on heroku. Thank you John!


Heroku buildpack with libvips installed.

Usage

Add this buildpack by running:

heroku buildpacks:add https://github.com/brandoncc/heroku-buildpack-vips

After running this command you should see the output similar to:

Buildpack added. Next release on amazing-earthfest will use:
  1. heroku/ruby
  2. https://github.com/brandoncc/heroku-buildpack-vips

Build script

This is the script used to build vips using docker.

VIPS_VERSION=x.y.z ./build.sh

After building a tar file, it will be copied to the build directory. Then you should commit this changes to git.

Build configurations

If you would like to see the output of vips --vips-version or vips --vips-config, both can be found for each stack in the build/configurations directory. These configuration logs are generated automatically during the build process, so they should always be up-to-date.