To install the Templarbit Agent with Heroku, you need to add a Buildpack, update the application settings and update the Procfile.

Installation

Step 1: Add Buildpack

The first step is to add the Templarbit Agent Buildpack to your application.

heroku buildpacks:add https://github.com/templarbit/agent-v5-heroku-buildpack

Step 2: Add Templarbit Credentials

The Templarbit Agent needs the Property ID and the Secret Key to connect to the Templarbit Cloud Engine. You can find your Property Credentials at app.templarbit.com. Follow these steps to set Heroku configuration environment variables:

heroku config:set TB_PROPERTY_ID=xxx
heroku config:set TB_SECRET_KEY=xxx

You can also manually set and update these variables in your Heroku Dashboard under the Settings tab.

Step 3: Update Procfile

The last step is updating your Heroku Profile. Prefix your web dyno with templarbit, for example:

web: templarbit bundle exec rails server

Step 4: Deploy your application

The next time Heroku deploys your application, the Templarbit Agent will be installed and your application will be protected by Templarbit.

Updating

The Templarbit Agent will update itself. To disable auto updates set the Heroku ENV variable TB_DISABLE_AUTO_UPDATES=true.

Uninstall

You can remove the Templarbit Agent from your application by removing the Templarbit Agent Buildpack. Please remember to re-deploy your application.