Heroku Caddy Buildpack

Run Caddy in Heroku.

Built according to Heroku's buildpack API.

Quick Start

Get the buildpack.tar.gz download URL from the latest release. It should look something like:

https://github.com/thermondo/heroku-buildpack-caddy/releases/download/LATEST_VERSION_NUMBER/buildpack.tar.gz

Then run:

heroku buildpacks:add <the-buildpack-url>

Then in your app's Procfile add something like this:

web: caddy --config <your Caddyfile>

If you want to run a specific version of Caddy, set the CADDY_RELEASE environment variable on your app as seen on Caddy's GitHub releases (for example: v2.8.4). Otherwise it will install the latest version of Caddy from GitHub.

🚨 If you choose to use the latest version of Caddy from GitHub, and there's a new MAJOR Caddy release, this buildpack will abort the build with a helpful log message telling you what to do in this case: Either pin the release you want with CADDY_RELEASE or check this repo for updates that support the latest major version.

Developing

Creating Releases

Go to the release workflow and manually trigger a release. Specify an appropriate tag name using semantic versioning rules.

Then go to the newly created draft release on the releases page, polish it up, and publish it.