Skip to main content
Version: v3.x


Before continuing, ensure you have the following pieces of software at the correct minimum versions installed on your machine:

Step 1. Install and authorize the Hasura CLI

You can download the CLI binary below. Please follow the instructions for your system.

Simply run the installer script in your terminal:

curl -L | bash

Step 1.1 Login with the CLI

After installation, from any directory, run the following command to authenticate your CLI session with Hasura DDN.
ddn auth login

A new window will open either asking you to sign in or authenticating your current session and allow you to return to the CLI.

Step 2. Install the Hasura VS Code extension

If you don't already have Visual Studio Code installed, we recommend you download and install it. Then, install the Hasura VS Code extension so that you can make use of features like autocomplete, contextual suggestions, and inline validation to enhance your development experience.

Step 3. Install Docker Compose v2.22.0 or greater

Finally, install Docker, which will be used for local development. This helps you iterate and develop locally without deploying any changes to Hasura DDN, making the development experience faster and your feedback loops shorter.

Docker version requirement

Docker Compose v2.22.0 or greater is required to run local services. To check your version of Docker Compose, run:

docker compose version

Click here to download the latest version of Docker which includes Docker Compose.

If you have Docker Desktop installed on your system you can upgrade from inside the application.

Console compatible browsers

Your browser settings, privacy tools or browser extensions may prevent the Console from accessing your local Hasura instance. This could be due to features designed to protect your privacy and security. Should you encounter one of these issues, we recommend disabling these settings for the domain.

Chrome and Firefox are the recommended browsers for the best experience with the Hasura Console including for local development.

Next Steps

At this point, you're ready to create your first supergraph!

Alternatively, if you've been invited to an existing supergraph repository, you might want to add a new subgraph, connect a data source, create a relationship, or add some business logic.