793

Product support

Visit this product's website for support.

Categories

Introduction

This plugin has 2 features as of now:

  1. A middleware class to allow OctoberCMS apps to run thro' the reverse proxy which Heroku uses.
  2. Helper to validate SSL certificates during the setup process.

Tutorial

You can find usage steps described here.

Heroku Reverse Proxy

Installing plugin will enable the middleware layer to enable this out of the box.

SSL certificate

If you are on a paid Heroku plan and would like to add SSL certificates to your website manually rather than using their Automated Certificate Management for some reason, then the Heroku plugin has additional provisions for enabling this. First install the plugin and deploy it to Heroku. Now visit the plugin's settings page and you will reach this: Heroku Settings Page

You need to add the challenge keys here which can be generated using certbot tool. First ensure it's installed by using:

brew install certbot

Then manually fetch the certificate:

sudo certbot certonly --manual

It will ask for the domain names and you can add www.yourwebsite.com and yourwebsite.com

Now it will throw out a URL and a challenge key for each domain. Copy the slug part of the URL and paste it in the challenge slug field and the challenge key in the key field. Do this for each domain and save the settings. Now go back to command line and hit enter which will validate the keys. And that's it, you have the certificates installed. You can upload them using:

heroku plugins:install heroku-certs
heroku certs:add /etc/letsencrypt/live/yourwebsite.com/fullchain.pem /etc/letsencrypt/live/yourwebsite.com/privkey.pem

And if you are on a paid plan, it should work fine.

1.0.1

First version of Heroku

Dec 13, 2020