Skip to content

shark-h/local-development

Repository files navigation

Prerequisites

Starting hasura

(1) Create an account on beta.hasura.io if you do not have one.

(2) Run:

hasuractl login

(3) After you have successfully logged in, run this command:

NOTE: Please be advised that if you are running the next command for the first time, it will roughly download about 1-1.5GB of docker images.

hasuractl local start

It might take a long time for this to finish, depending on your internet connection. The command exits by pointing you to a url to login to the console.

Stopping hasura

hasuractl local stop

This will stop the running hasura platform. You can start it again by running hasuractl local start.

Cleaning hasura

If you like to clean the existing hasura platform to start afresh, you can run this:

hasuractl local clean

NOTE: The above command will delete all data and configuration. However, the underlying VM is not deleted and hence the downloaded images still exist inside the VM. This is what you should be using if you plan to run hasuractl local start again. If you would also like to delete the underlying VM, you should run this:

hasuractl local delete

The above command will delete the the VM completely and hence all the downloaded images with it.

Updating the platform version:

The current version of the platform is v0.12.2. No major features are added since v0.11. However, we will provide instructions to upgrade to v0.12 soon.

Errors:

When you try to login to the console, if it fails with a message saying 'postgres.hasura' is not resolved, run this command:

kubectl delete po -n kube-system -l k8s-app=kube-dns

Wait for a few seconds and try again.

Exposing local hasura to public Internet

Follow the instructions here: https://github.com/hasura/ngrok

Upcoming features

  • Migration from local development to Kubernetes cluster on any cloud provider.

About

Run Hasura locally on your computer

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published