Part I: Creating a project

Let’s start by creating a project:

  1. Create an account on beta.hasura.io
  2. Click on create a project
    • Choose an infrastructure provider (DigitalOcean or a 7 day preview project hosted by Hasura)
    • Enter your provider’s API tokens
  3. Your project will be ready in 10-20 mins, and you’ll get an email with login credentials

Terminology

Project name

Typically a word followed by an number; randomly generated when you create a project. Eg: test42. It’ll be referred to as <project-name>.

Project domain

The domain which will resolve to your hasura project. By default, it is <project-name>.hasura-app.io or hasura.test (local).

Services

A service is an abstract entity which captures a running web/tcp server. There are several services that come out of the box with hasura platform like data, auth and console.

An HTTP service, say svc is typically exposed using a subdomain at <svc>.<project-name>.hasura-app.io. For example, the data service is exposed at data.<project-name>.hasura-app.io.

Gateway

The Gateway is the entrypoint for your project. Every request to the project goes through the gateway and is then routed to the appropriate service. For example, all requests on data.<project-name>.hasura-app.io are forwarded to the built-in hasura provided data service.

Console

The UI service that helps you manage data, users and other services in your project. It can be accessed at console.<project-name>.hasura-app.io

Admin user

The admin user is a special user who can manage the project. The credentials for the admin user are sent in an email after the project creation is completed. In case of local setup, the password for the admin user is password. You can use these credentials to login to the console.

Note

Every project gets its own admin user. beta.hasura.io is the dashboard where you can create multiple projects. Login credentials that are generated for your project (and sent to you via email) have nothing to do with the login credentials of beta.hasura.io .

Admin token

When you login to the console with the admin user credentials, you can see the admin token listed under the “Project Info” section.