Updating Hasura GraphQL engine on Heroku

This guide will help you update the Hasura GraphQL engine running on Heroku. This guide assumes that you already have a Hasura GraphQL engine running on Heroku.

The current latest version is:


Follow these steps to update Hasura GraphQL engine to the lastest version:

Step 1: Clone the Hasura GraphQL engine Heroku app

The Hasura app with Heroku buildpack/configuration is available at: https://github.com/hasura/graphql-engine-heroku.

Clone the above repository.

git clone https://github.com/hasura/graphql-engine-heroku
cd graphql-engine-heroku

If you already have this, then pull the latest changes which will have the updated GraphQL engine Docker image.

Step 2: Attach your Heroku app

Let’s say your Heroku app is called hasura-heroku and is running on https://hasura-heroku.herokuapp.com.

Navigate to your project directory, use the Heroku CLI to configure the git repo you cloned in Step 1 to be able to push to this app.

# Replace <hasura-heroku> with your Heroku app's name
heroku git:remote -a <hasura-heroku>
heroku stack:set container -a <hasura-heroku>

You can find your Heroku git repo in your Heroku - Settings - Info - Heroku Git URL

Step 3: git push to deploy the latest Hasura GraphQL engine

When you git push to deploy, the Heroku app will get updated with the latest changes:

git push heroku master

Deploy a specific version of the Hasura GraphQL engine

Head to the Dockerfile in the git repo you cloned in step 1. Change the FROM line to the specific version you want. A list of all releases can be found at https://github.com/hasura/graphql-engine/releases.

FROM hasura/graphql-engine:v1.0.0


Change v1.0.0 to v1.1.0 for example, commit this and then git push heroku master to deploy.


If you are downgrading to an older version of the GraphQL engine you might need to downgrade your metadata catalogue version as described in Downgrading Hasura GraphQL engine