graphql-engine/docs/graphql/manual/getting-started/using-existing-database.rst

.. meta::
   :description: Get started with Hasura using an existing database
   :keywords: hasura, docs, start, existing database

.. _using_existing_database:

Getting started with an existing database
=========================================

.. contents:: Table of contents
  :backlinks: none
  :depth: 1
  :local:

Follow one of these guides to set up Hasura GraphQL engine using an existing database:

- `Using Hasura Cloud <https://hasura.io/docs/cloud/1.0/manual/projects/create.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 Heroku <heroku_existing_db>`: Run on Heroku and connect to an existing
  Heroku Postgres database.
- :ref:`Using Kubernetes <deploy_kubernetes>`: Run on Kubernetes and connect to an existing Postgres
  database.