Skip to main content
Version: v2.x

Docker networking

Introduction

Sometimes you might want to connect Hasura running in Docker with APIs (e.g. auth webhooks, event triggers, remote schemas) that are either running outside of Docker or in a different Docker container. Depending on the setting, the network config is different. This section shows how to connect in each of these use cases.

Network config

ConnectionConfigComment
Hasura to API (outside Docker)
  1. With --net=host, localhost:3000
  2. Otherwise, <docker-bridge-ip>:3000, e.g. 172.17.0.1:3000
  1. Assuming the API is running on port 3000
  2. The Docker bridge IP can be found via ifconfig
API (outside Docker) to Hasuralocalhost:8080Hasura runs on port 8080 by default
Hasura to API (both in docker-compose)service name, e.g.: api:3000Assuming the API is running on port 3000
API to Hasura (both in docker-compose)service name, e.g.: hasura:8080Hasura runs on port 8080 by default
Hasura to API (both running with separate docker run)Docker internal IP addressCan be obtained with docker inspect
API to Hasura (both running with separate docker run)Docker internal IP addressCan be obtained with docker inspect

Advanced

Learn more about Docker specific networking in the Docker documentation.