graphql-engine/docs/graphql/core/getting-started/index.rst
2020-09-08 23:13:46 +05:30

60 lines
1.8 KiB
ReStructuredText

.. meta::
:description: Get started with Hasura
:keywords: hasura, docs, start
.. _getting_started:
Getting Started
===============
.. contents:: Table of contents
:backlinks: none
:depth: 1
:local:
Introduction
------------
To use the Hasura GraphQL engine, you need to:
- Deploy the Hasura GraphQL engine with access to a Postgres database
- Set up and test your GraphQL API using the Hasura console UI *(also possible via the CLI or API)*
- Consume the generated GraphQL API from your client apps
Get started from scratch
------------------------
- :ref:`Using Hasura Cloud <cloud_getting_started>` **(recommended)**: Create
a new Hasura Cloud project with just a few clicks.
- :ref:`Using Docker <docker_simple>`: Run a **local development** setup that sets up both the Hasura GraphQL
engine and Postgres using Docker Compose.
Get started using an existing database
--------------------------------------
- :ref:`Using Hasura Cloud <cloud_getting_started>` **(recommended)**: Create a new Hasura Cloud project connected to an existing Postgres database.
- :ref:`Using Docker <deployment_docker>`: Run as a docker container and connect to an existing Postgres
database.
- :ref:`Using Kubernetes <deploy_kubernetes>`: Run on Kubernetes and connect to an existing Postgres
database.
.. admonition:: Supported Postgres versions
Hasura GraphQL engine supports **Postgres 9.5 and above**
.. admonition:: MySQL support (alpha)
Head to :ref:`this guide <mysql_preview>` to try out the MySQL preview.
.. toctree::
:maxdepth: 2
:titlesonly:
:hidden:
Hasura Cloud quickstart <https://hasura.io/docs/1.0/graphql/cloud/getting-started/index.html>
Docker quickstart <docker-simple>
Using an existing database <using-existing-database>
first-graphql-query
first-event-trigger