Skip to main content

GraphQL Playground

The API Playground was an in-browser tool for testing, running and sharing Dagger API queries. It has since been decommissioned.

The recommended approach is to use the dagger query sub-command, which provides an easy way to send raw GraphQL queries to the Dagger API from the command line.

Running the GraphQL API locally​

In order to run the GraphQL API locally and explore, you can follow these steps:

note

This will start the Dagger GraphQL server and allow CORS requests on http://127.0.0.1:8080/query.

You can then use a GraphQL client like Altair to connect to the API server and explore the Dagger API/schema.

  1. Install Dagger CLI and a container runtime (e.g. Docker)
  2. Clone or create a Dagger module repository (you can use the CI quickstart as a starting point)
  3. Open a terminal and navigate to the root of your Dagger module repository (the directory with the dagger.json file)
  4. Set the DAGGER_SESSION_TOKEN environment variable to test (or your desired token)
  5. Run the following command: env DAGGER_SESSION_TOKEN=test dagger listen --allow-cors
  6. Use Basic Authentication with the DAGGER_SESSION_TOKEN value as the username and password (e.g. test would be the header Authorization: Basic dGVzdDo=)