---
title: "Deploy GraphQL Hive Console"
description: "Self-hosted GraphQL Hive: schema registry + usage analytics. Zero inputs."
category: "Observability"
url: https://railway.com/deploy/graphql-hive-console
---

# Deploy GraphQL Hive Console

Self-hosted GraphQL Hive: schema registry + usage analytics. Zero inputs.

**[Deploy GraphQL Hive Console on Railway](https://railway.com/template/graphql-hive-console)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/graphql-hive-console/manifest.json

- **Creator:** jakubdev
- **Category:** Observability
- **Total deploys:** 1

## Template content

### usage https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/usage:14.1.0
- **Health check:** /_health

### clickhouse https://devicons.railway.app/clickhouse

- **Image:** clickhouse/clickhouse-server:26.3.12.3-alpine
- **Health check:** /ping

### app https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/app:14.1.0
- **Health check:** /_health

### migrations https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/storage:14.1.0

### workflows https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/workflows:14.1.0
- **Health check:** /_health

### policy https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/policy:14.1.0
- **Health check:** /_health

### redis https://devicons.railway.app/redis

- **Image:** ghcr.io/kolebjak/railway-hive-redis:14.1.0

### usage-ingestor https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/usage-ingestor:14.1.0
- **Health check:** /_health

### db https://devicons.railway.app/postgres

- **Image:** postgres:16.4-alpine

### schema https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/graphql-hive/schema:14.1.0
- **Health check:** /_health

### broker https://cdn.simpleicons.org/apachekafka/white

- **Image:** ghcr.io/kolebjak/railway-hive-broker:14.1.0

### s3 https://devicons.railway.app/aws

- **Image:** ghcr.io/kolebjak/railway-hive-s3:14.1.0
- **Health check:** /minio/health/live

### server https://raw.githubusercontent.com/graphql-hive/console/main/packages/web/app/public/just-logo.svg

- **Image:** ghcr.io/kolebjak/railway-hive-server:14.1.0
- **Health check:** /_health

### edge https://cdn.simpleicons.org/caddy

- **Image:** ghcr.io/kolebjak/railway-hive-edge:14.1.0
- **Health check:** /_health
- **Public domain:** Yes

## Documentation

# Deploy and Host GraphQL Hive Console on Railway

> **After your first sign-up, set `DISABLE_SIGNUP=1` on the `edge` service** and redeploy it. Hive has no sign-up switch and no instance owner: anyone who can open the console can register and create an organization (graphql-hive/console#8039). The switch returns 403 for email+password registration; sign-in, password reset and social/OIDC login are unaffected. Details: https://github.com/kolebjak/railway-hive#closing-sign-up

GraphQL Hive Console is the open-source schema registry for GraphQL: it stores every published schema, runs breaking-change checks in CI, composes federated supergraphs, serves them to gateways over a CDN endpoint, and shows field-level usage analytics collected from your gateway or server. This template is the self-hosted console pinned to hive@14.1.0.

## About Hosting GraphQL Hive Console

Hive Console is thirteen containers: the web app, the GraphQL API server, the schema and policy services, the workflows worker, the usage endpoint and its ingestor, a one-shot migrations job, PostgreSQL, ClickHouse, Redis, a Redpanda (Kafka API) broker and an S3-compatible store. This template maps them one-to-one onto Railway services wired over the private network, generates every secret with Railway template functions, attaches volumes to Postgres, ClickHouse, Redis, Redpanda, S3 and the server key store, and adds one Caddy service, `edge`, that owns the single public domain: the console at `/`, the GraphQL API at `/graphql`, CDN artifacts at `/artifacts/v1/...` and usage reporting at `/usage`. One origin means login works on the generated Railway domain, no custom domain needed. Nothing is required at deploy time.

## Common Use Cases

- Schema registry with breaking-change checks in CI for a single GraphQL API
- Federation supergraph composition served to Hive Gateway, Hive Router or Apollo Router
- Field-level usage analytics to find unused fields before removing them

## Dependencies for GraphQL Hive Console Hosting

- PostgreSQL 16, ClickHouse 26, Redis 7, Redpanda v23, versitygw (S3) and Caddy are all included in the template
- A gateway or SDK in your own project that reports usage and pulls the supergraph from the edge domain
- Optional: SMTP or Postmark credentials on the workflows service to send invite and alert emails
- Optional: a custom domain on `edge`

### Implementation Details

After deploy: open the edge domain, sign up, set `DISABLE_SIGNUP=1` on `edge`, create an organization, a project and a target. Create a registry token (schema:publish + usage:report) and a CDN token. Configure your gateway with the CDN URL `https://EDGE_DOMAIN/artifacts/v1/TARGET_ID`, the CDN key, the registry token and the usage endpoint `https://EDGE_DOMAIN/usage`. Source, local compose check and upgrade notes: https://github.com/kolebjak/railway-hive

## Why Deploy GraphQL Hive Console on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying GraphQL Hive Console on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Rootprint](https://railway.com/deploy/rootprint-1) — Open-source logs and traces with full-text search on object-storage.
- [Pyroscope profiling](https://railway.com/deploy/pyroscope-profiling) — Protected continuous profiling with durable Pyroscope storage.
- [SigOnly](https://railway.com/deploy/sigonly) — Deploy SigNoz with a working demo app & config in one click

Open this page in a browser: https://railway.com/deploy/graphql-hive-console
