graphql-engine/docs/graphql/manual/deployment/heroku/using-existing-heroku-database.rst

Using existing Heroku database
==============================

Let's say you have an existing `Heroku Postgres <https://www.heroku.com/postgres>`_ database with data in it, and you'd
like add GraphQL on it.

.. note::

   In case you're exposing an existing database (esp. if it is production), please configure an access key
   for the console and the GraphQL endpoint.

Step 0: Deploy Hasura on Heroku
-------------------------------

Deploy Hasura on Heroku by clicking on this button:

.. image:: https://camo.githubusercontent.com/83b0e95b38892b49184e07ad572c94c8038323fb/68747470733a2f2f7777772e6865726f6b7563646e2e636f6d2f6465706c6f792f627574746f6e2e737667
  :width: 200px
  :alt: heroku_deploy_button
  :class: no-shadow
  :target: https://heroku.com/deploy?template=https://github.com/hasura/graphql-engine-heroku

Follow the Heroku instructions to deploy, check if the Hasura console loads up when you **View app** and then head
to the **Manage App** screen on your Heroku dashboard.

Step 1: Remove the existing Postgres addon in the app
-----------------------------------------------------

Head to your Heroku dashboard and delete the Postgres addon:

.. image:: ../../../../img/graphql/manual/deployment/remove-heroku-postgres-addon.png

Step 2: Configure the DATABASE_URL environment variable
-------------------------------------------------------

Now configure the ``DATABASE_URL`` with your existing Heroku Postgres database URL.

.. image:: ../../../../img/graphql/manual/deployment/heroku-database-url-access.png

Step 3: Track tables and relationships
--------------------------------------

Wait for the GraphQL engine to restart and you'll see your existing tables as "untracked tables" in the console.

.. image:: ../../../../img/graphql/manual/getting-started/TrackTable.jpg