graphql-engine/docs/graphql/manual/getting-started/index.rst
2020-07-23 14:34:17 +02:00

59 lines
2.0 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:
To use the Hasura GraphQL engine, you need to:
#. Run the Hasura GraphQL engine with access to a Postgres database
#. Use the Hasura console (an admin UI) that connects to the Hasura GraphQL engine to help you build your schema and
run GraphQL queries
.. thumbnail:: /img/graphql/manual/getting-started/running-hasura.png
:width: 75%
:class: no-shadow
:alt: Running Hasura
Get started from scratch
------------------------
- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>`__ **(recommended)**: Create a new Hasura Cloud project with just one click.
- :ref:`Using Docker <docker_simple>`: Run a **local development** setup that sets up both the Hasura GraphQL
engine and Postgres using Docker.
- :ref:`Using Heroku <heroku_one_click>`: Get started quickly with no setup required to
host the Hasura GraphQL engine and Postgres on Heroku.
Get started using an existing database
--------------------------------------
- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>`__ **(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**
.. toctree::
:maxdepth: 2
:titlesonly:
:hidden:
Hasura Cloud quickstart <https://hasura.io/docs/cloud/1.0/manual/getting-started/index.html>
Docker quickstart <docker-simple>
Using an existing database <using-existing-database>
first-graphql-query
first-event-trigger