Hasura quickstart

This quickstart guide will help you get Hasura GraphQL Engine up and running with Container Apps on Crunchy Bridge. We recommend you start with the Container Apps Quickstart to get a general understanding of Container Apps.

About Hasura

From the Hasura project:

Hasura GraphQL Engine is a blazing-fast GraphQL server that gives you instant, realtime GraphQL APIs over Postgres, with webhook triggers on database events, and remote schemas for business logic.

Hasura helps you build GraphQL apps backed by Postgres or incrementally move to GraphQL for existing applications using Postgres.

Read more at hasura.io and the docs.

Hasura with Postgres container apps Quickstart

First, make sure you have Container Apps enabled. As a user with superuser privileges, run CREATE EXTENSION pgpodman; to install the extension in the postgres database of the desired cluster.

Next, find your cluster's database URL to include as the DATABASE_URL parameter when you run the container. You can find the URL in the Connection section of the cluster dashboard (choose the application role), or by running cb uri --role application <cluster name> on the command line.

To start your Hasura app, run the following using your own value for HASURA_GRAPHQL_DATABASE_URL:

SELECT run_container('-dt -p 5433:8080/tcp -e HASURA_GRAPHQL_DATABASE_URL="your-database-URL" --privileged docker.io/hasura/graphql-engine');
Copy

Now you can visit your running Hasura GraphSQL Engine at your-host-URL:5433. You can find your Host URL in the Overview section of your cluster dashboard, or by running cb info <cluster name>.