graphql-engine/install-manifests/docker-compose-https/README.md

# Hasura GraphQL Engine on Docker with HTTPS

This Docker Compose setup runs [Hasura GraphQL Engine](https://github.com/hasura/graphql-engine) with [Caddy](https://caddyserver.com) webserver and automatic HTTPS certs from [LetsEncrypt](https://letsencrypt.org/).

## Pre-requisites

- [Docker](https://docs.docker.com/install/)
- [Docker Compose](https://docs.docker.com/compose/install/)

## Usage

- Clone this repo on a machine with a public ip address
- Map your domain name to this ip address
- Edit `Caddyfile` and add your domain (replace `<your-domain.com>` with your domain, don't keep `<>`)
- Edit `docker-compose.yaml` and change `HASURA_GRAPHQL_ADMIN_SECRET` to something secure
- `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**
add installation manifests (#432) 2018-09-13 12:33:13 +03:00			`# Hasura GraphQL Engine on Docker with HTTPS`

			`This Docker Compose setup runs [Hasura GraphQL Engine](https://github.com/hasura/graphql-engine) with [Caddy](https://caddyserver.com) webserver and automatic HTTPS certs from [LetsEncrypt](https://letsencrypt.org/).`

			`## Pre-requisites`

			`- [Docker](https://docs.docker.com/install/)`
			`- [Docker Compose](https://docs.docker.com/compose/install/)`

			`## Usage`

			`- Clone this repo on a machine with a public ip address`
			`- Map your domain name to this ip address`
			- Edit `Caddyfile` and add your domain (replace `<your-domain.com>` with your domain, don't keep `<>`)
rename access-key to admin-secret (close #1347) (#1540) Rename the admin secret key header used to access GraphQL engine from X-Hasura-Access-Key to X-Hasura-Admin-Secret. Server CLI and console all support the older flag but marks it as deprecated. 2019-02-14 12:37:47 +03:00			- Edit `docker-compose.yaml` and change `HASURA_GRAPHQL_ADMIN_SECRET` to something secure
add installation manifests (#432) 2018-09-13 12:33:13 +03:00			- `docker-compose up -d`

introduce v1/graphql (fix #1368) (#2064) Changes compared to `/v1alpha1/graphql` * Changed all graphql responses in /v1/graphql endpoint to be 200. All graphql clients expect responses to be HTTP 200. Non-200 responses are considered transport layer errors. * Errors in http and websocket layer are now consistent and have similar structure. 2019-05-10 09:05:11 +03:00			GraphQL endpoint will be `https://<your-domain.com>/v1/graphql`
add installation manifests (#432) 2018-09-13 12:33:13 +03:00			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`