Dgraph GraphQL Tour

Introduction

Run Dgraph

You can run an instance of Dgraph on your local supported machine, but to make this tutorial easier to follow along with for all users, we will use Dgraph Cloud.

Dgraph Cloud provides Dgraph database as a managed service, so you can focus on building apps and websites instead of deploying and managing hardware and servers.

Dgraph Cloud offers three service tiers to support your database needs as your database needs grow. For this tutorial, you will use Starter (Free) instance. The Starter instance can be launched for free with a 1 Mb daily data transfer limit. Dgraph Cloud provides additional tiers to provide Dgraph for non-evaluation purposes; to learn more, see the Dgraph Pricing Page.

To get started, Sign Up for Dgraph Cloud. After you are logged in, you will be prompted to launch a new backend. Select the Starter (Free) instance, and then click Launch.

Launching a new backend will take a few minutes to allocate the services and deploy your environment. Once deployed, Dgraph Cloud will provide you with a GraphQL Endpoint URL.

Copy the GraphQL Backend Endpoint URL and paste it below. You will use this GraphQL Endpoint URL for the remainder of this tutorial.

Endpoint URL:

In the next step of this tour, you will submit a schema to your backend. This tour can automate this process if authorized on your backend with an Admin API Key. To generate this Admin API Key, go to the API Keys Settings tab. The API Keys page on Dgraph Cloud enables you to create new keys and delete existing keys. Click on Create New, and then name the key anything that will help you identify it for later removal, such as ‘tutorial’. Ensure that Admin is selected for the key type, and then click Create. Copy the API Key and paste into the form below:

API Key:

If you close this window, the endpoint URL and API Key will not be saved for security reasons. We recommend copying the API Key to a safe place for further reference or else you may need to generate a new API key the next time you access the tour.

1.2 Run Dgraph