Creating projects

Introduction

You can create a new Hasura Cloud project with either a new Postgres database, or an existing Postgres database with a publicly available IP address.

Step 1: Project setup

To begin, navigate to the Projects page, and click the New Project link.

create new project button

This opens a form on the right where you can create your new project.

Enter the project name, choose a pricing plan and select a region for your project in this form.

project setup

Once you have completed the project setup, continue to the database setup.

Step 2: Database setup

New database

Hasura Cloud does not host databases, but does provide integrations with which you can create databases on managed cloud providers like Heroku. Integrations for AWS, GCP, and Azure are coming soon.

To get started, click Try with Heroku, and follow the prompts to authenticate with Heroku. Hasura Cloud will integrate with your Heroku account and manage the initial setup of a dev-tier Postgres instance. You can always upgrade the instance and manage options later through your Heroku account.

database setup with new database

Existing database

To connect an existing Postgres database to your new project, click Enter Database URL, and enter your database connection string (looks like postgres://username:password@hostname:port/dbname).

database setup with existing database

Allowing connections from Hasura Cloud IP

For some cloud services, like GCP, you’ll need to adjust your Postgres connection settings to allow connections from the Hasura Cloud IP address. You can copy the IP address from either the copy icon in the Database Setup , or the Hasura Cloud IP field on the project’s details view. You may also need to disable SSL. Adding custom cert information to a Hasura Cloud instance is not yet available.

Existing database setup Hasura Cloud IP field whitelist Hasura instance IP in Postgres settings

Postgres requirements

Hasura Cloud works with Postgres versions 9.5 and above.

Make sure your database user has the right Postgres permissions.

Connecting to a database not exposed over the internet

Contact us for VPC peering and on-premise solutions.

More databases

Support for more databases (MySQL, SQL Server etc) is coming soon.