Prerequisites
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
Download the CLI binary below. Please follow the instructions for your system.
- macOS and Linux
- Windows
Simply run the installer script in your terminal:
curl -L https://graphql-engine-cdn.hasura.io/ddn/cli/v4/get.sh | bash
- Download the latest DDN CLI installer for Windows.
- Run the
DDN_CLI_Setup.exe
installer file and follow the instructions. This will only take a minute. - By default, the DDN CLI is installed under
C:\Users\{Username}\AppData\Local\Programs\DDN_CLI
- The DDN CLI is added to your
%PATH%
environment variable so that you can use theddn
command from your terminal.
Step 1.1 Login with the CLI
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.27.1 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 Compose v2.27.1
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.
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 console.hasura.io
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.