Skip to main content
Version: v2.x

Get Started with Docker (Hasura & ClickHouse)

Testing is currently underway on the ClickHouse connector for use in self-hosted environments. Our suggested installation method is to use Docker Compose to deploy a working instance of Hasura with the ClickHouse Connector enabled.

In order to do this, follow the instructions for Hasura Enterprise Edition, but change out the Docker Compose files listed in that documentation to these values:

# in a new directory run
# or run
curl -o docker-compose.yml

When you use these to launch the services, you'll see three containers running instead of two. The third container is the ClickHouse GraphQL Connector agent. By navigating to the Hasura Console after execution, you'll find the ClickHouse data source as a type that can now be added to your Hasura GraphQL Service instance.

You can check the health of the connector using the /health endpoint. The connector is available at the following endpoint:


You can follow the instructions from this step onward to connect to your ClickHouse instance and begin using it with Hasura.

Keep up to date


Currently, Hasura supports read-only queries, relationships, and permissions on ClickHouse. Column comparison operators are not supported with permissions on ClickHouse.

Please watch this space to get the latest docs on how you can try these features out via the Console or by manipulating Metadata in JSON/YAML directly.

If you'd like to stay informed about the status of ClickHouse support, subscribe to our newsletter and join our discord!