graphql-engine/install-manifests/docker-compose-postgis/README.md
Samir Talwar 349ccd3296 Use docker compose, not docker-compose.
Docker Compose is now a plugin for Docker, bundled by default in Docker Desktop and many Linux distribution packages. The standalone `docker-compose` binary has been deprecated since Docker Compose v2.

Using the new version directly allows us to write development scripts that do not require `docker-compose` to be installed.

PR-URL: https://github.com/hasura/graphql-engine-mono/pull/5185
GitOrigin-RevId: c8542b8b2405d1aa32288991688c6fde4af96383
2022-08-02 10:30:57 +00:00

27 lines
983 B
Markdown

# Hasura GraphQL Engine on Docker
This Docker Compose setup runs [Hasura GraphQL Engine](https://github.com/hasura/graphql-engine) along with Postgres with the postgis extension using `docker-compose`.
See [this blog post for a tutorial](https://hasura.io/blog/graphql-and-geo-location-on-postgres-using-hasura-562e7bd47a2f).
## Pre-requisites
- [Docker](https://docs.docker.com/install/)
- [Docker Compose](https://docs.docker.com/compose/install/)
## Usage
- Clone this repo on a machine where you'd like to deploy graphql engine
- `docker compose up -d`
GraphQL endpoint will be `https://<your-domain.com>/v1/graphql`
Console will be available on `https://<your-domain.com>/console`
## Connecting to External Postgres
If you want to connect to an external/existing postgres database, replace `HASURA_GRAPHQL_DATABASE_URL` in `docker-compose.yaml` with your database url.
**Note: localhost will resolve to the container ip inside a docker container, not the host ip**