Documentation

We are here to help you get from zero to one fast.

Get Started    Discussions

Heroku

read time 3 mins

Doppler's Heroku integration is a great way for Heroku users to sync a config's secrets with a Heroku app's config vars. Syncing with Heroku also adds another layer of high availability for your service, as now Heroku will also have the latest copy of your secrets. Our Heroku integration is a standalone service, that does not require the use of the Doppler CLI. Setup is quick and takes less than 3 minutes.

Prerequisites

  • You have an account setup at Heroku and have deployed some code

Import Secrets

You can quickly move your secrets to Doppler by exporting your app's config vars via the Heroku CLI.

heroku config --json

You can then upload those secrets to Doppler by clicking the Upload JSON/env file button.

Connect to Heroku

In your project, navigate to Integrations and select "Heroku":

We will redirect you to Heroku to authorize Doppler to your account:

Setup Integration

In the next screen, you can select your Heroku App you would like to integrate with a specific Doppler config:

Select your Heroku App and the Doppler config you would like to integrate with. Hit "Setup Integration" and you are all set!

🚧

Review Apps

Heroku Sync currently does not support Heroku Review Apps.

Reserved secrets & Addons

Note that Doppler will not overwrite secrets from installed Heroku Addons, as well as the following secrets when syncing to Heroku:

Secret

Description

HEROKU_APP_ID

Heroku app's id

HEROKU_APP_NAME

Heroku app's name

HEROKU_RELEASE_CREATED_AT

Heroku app's current release created date

HEROKU_RELEASE_VERSION

Heroku app's current release version

HEROKU_SLUG_COMMIT

Heroku app's current release commit

HEROKU_SLUG_DESCRIPTION

Heroku app's current release description

πŸ‘

Amazing Work!

Now you are all set up on Heroku. Every time you update your secrets in Doppler, we will automatically update them in your Heroku App.

Updated about a month ago


Heroku


read time 3 mins

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.