mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-15 01:12:56 +03:00
349ccd3296
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
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
# 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 `:80` with your domain to get automatic HTTPS certs from [LetsEncrypt](https://letsencrypt.org/))
|
|
- 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**
|
|
|
|
|