Templarbit

Templarbit Resources

Welcome to the Templarbit developer resources. You'll find comprehensive guides and documentation to help you start securing your applications and websites with Templarbit as quickly as possible. Let's jump right in!

Get Started

Heroku

In order to use the Templarbit Agent with your Heroku application, we provide a Heroku Buildpack that will install the Templarbit Agent alongside your application.

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

Step 1: Add Buildpack

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

heroku buildpacks:add https://heroku-buildpacks.templarbit.com/templarbit-agent-v4.tar.gz

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

Every time you deploy your Heroku application, our Buildpack will check for the latest Templarbit Agent version 4.x.x and install it.

It's possible to pin a specific Templarbit Agent version by adding the specific Buildpack.

heroku buildpacks:add https://heroku-buildpacks.templarbit.com/templarbit-agent-v.tar.gz

The Templarbit Agent uses Semantic Versioning and we don't recommend pinning a specific version.

Uninstall

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


What's Next

Learn how to further configure the Templarbit Agent with ENV variables

Getting started