Installation

You can download the CLI binary below. The latest version of the CLI is v1.0.1. Please follow the instructions for your system.

macOS and Linux

Simply run the installer script in your terminal:

curl -L https://graphql-engine-cdn.hasura.io/ddn/cli/v3/get.sh | bash

Windows

Download the latest cli-ddn-windows-amd64.exe binary and run it.

curl -L https://graphql-engine-cdn.hasura.io/ddn/cli/v3/latest/cli-ddn-windows-amd64.exe -o ddn.exe

Unrecognized application warning

In Windows, if you get an "Unrecognized application" warning, click "Run anyway".

Additionally, you'll need to add this executable to your system's PATH:

Step 1: Locate the and rename the executable: Find the full path to the directory containing the executable. For example, if the executable is located in C:\Program Files\cli-ddn-windows-amd64.exe, note this path. Also, rename it to ddn for ease when writing commands later on.

Step 2: Open System Properties:

• Press Win + X and select System.
• Click on Advanced system settings on the left side.
• In the System Properties window, click on the Environment Variables button.

Step 3: Edit the PATH Variable:

• In the Environment Variables window, find the System variables section.
• Scroll down and select the Path variable, then click Edit.
• In the Edit Environment Variable window, click New and paste the path to the directory containing your executable (e.g., C:\Program Files\ddn.exe).

Step 4: Save Your Changes:

• Click OK to close the Edit Environment Variable window.
• Click OK to close the Environment Variables window.
• Click OK to close the System Properties window.

Step 5: Verify the Changes: Open a new Command Prompt or PowerShell window and type the following.

From any directory, run:

ddn

Verify Installation

Running ddn should print the following message:

DDDDDDD\   DDDDDDD\   NN\   NN\
DD  __DD\  DD  __DD\  NNN\  NN |
DD |  DD | DD |  DD | NNNN\ NN |
DD |  DD | DD |  DD | NN NN\NN |
DD |  DD | DD |  DD | NN \NNNN |
DD |  DD | DD |  DD | NN |\NNN |
DDDDDDD  | DDDDDDD  | NN | \NN |
\_______/  \_______/  \__|  \__|

Usage:
  ddn [command]

DDN operations
  project        Manage Hasura DDN Project

Metadata operations
  command        Perform Command related operations
  connector      Perform Connector related operations
  connector-link Perform DataConnectorLink related operations
  model          Perform Model related operations
  subgraph       Perform Subgraph related operations
  supergraph     Perform Supergraph related operations

Authentication operations
  auth           Manage Hasura DDN CLI Auth

Other operations
  context        Perform context operations
  help           Help about any command
  plugins        Manage plugins for the CLI
  update-cli     Update this CLI to the latest version or to a specific version
  version        Prints the CLI version

Flags:
  -h, --help               help for ddn
      --log-level string   Log level. Can be DEBUG, WARN, INFO, ERROR, or FATAL. (default "INFO")
      --no-prompt          Do not prompt for required but missing flags
      --out string         Output format. Can be table, json or yaml. (default "table")
      --timeout int        Request timeout in seconds [env: HASURA_DDN_TIMEOUT] (default 100)

Use "ddn [command] --help" for more information about a command