OS Manuals

/usr/bin/hive-gateway

GraphQL gateway that federates or proxies multiple GraphQL services behind one endpoint

From graphql-hive-gateway 2.15.3-r0 (enterprise-packages), captured 2026-11-08 by running hive-gateway --help (exit 0). permalink

Usage: hive-gateway [options] [command]

Unify and accelerate your data graph across diverse services with Hive Gateway,
which seamlessly integrates with Apollo Federation.

Options:
  --fork <number>                                           number of workers to spawn. (default: 1) (env: FORK)
  -c, --config-path <path>                                  path to the configuration file. defaults to the following files respectively in the current working directory: gateway.ts, gateway.mts, gateway.cts, gateway.js, gateway.mjs, gateway.cjs (env: CONFIG_PATH)
  -h, --host <hostname>                                     host to use for serving (default: 0.0.0.0) (env: HOST)
  -p, --port <number>                                       port to use for serving (default: 4000) (env: PORT)
  --polling <duration>                                      schema polling interval in human readable duration (default: 10s) (env: POLLING)
  --render-legacy-graphiql                                  render the legacy GraphiQL interface (default: false) (env: RENDER_LEGACY_GRAPHIQL)
  --no-masked-errors                                        don't mask unexpected errors in responses
  --masked-errors                                           mask unexpected errors in responses (default: true)
  --opentelemetry [exporter-endpoint]                       Enable OpenTelemetry integration with an exporter using this option's value as endpoint. By default, it uses OTLP HTTP, use "--opentelemetry-exporter-type" to change the default. (env: OPENTELEMETRY)
  --opentelemetry-exporter-type <type>                      OpenTelemetry exporter type to use when setting up OpenTelemetry integration. Requires "--opentelemetry" to set the endpoint. (choices: "otlp-http", "otlp-grpc", default: "otlp-http", env: OPENTELEMETRY_EXPORTER_TYPE)
  --hive-registry-token <token>                             [DEPRECATED] please use "--hive-target" and "--hive-access-token" (env: HIVE_REGISTRY_TOKEN)
  --hive-usage-target <target>                              [DEPRECATED] please use --hive-target instead. (env: HIVE_USAGE_TARGET)
  --hive-target <target>                                    Hive registry target to which the usage and tracing data should be reported to, and against which a dev supergraph source is composed remotely (see "--dev-remote"). Requires either "--hive-access-token <token>", "--hive-usage-access-token <token>" or "--hive-trace-access-token" option (env: HIVE_TARGET)
  --hive-access-token <token>                               Hive registry access token for usage metrics reporting and tracing. Enables both usage reporting and tracing. Also used for remote composition of a dev supergraph source (see "--dev-remote"). Requires the "--hive-target <target>" option (env: HIVE_ACCESS_TOKEN)
  --hive-usage-access-token <token>                         Hive registry access token for usage reporting. Enables Hive usage report. Requires the "--hive-target <target>" option. It can't be used together with "--hive-access-token" (env: HIVE_USAGE_ACCESS_TOKEN)
  --hive-trace-access-token <token>                         Hive registry access token for tracing. Enables Hive tracing. Requires the "--hive-target <target>" option. It can't be used together with "--hive-access-token" (env: HIVE_TRACE_ACCESS_TOKEN)
  --hive-trace-endpoint <endpoint>                          Hive registry tracing endpoint. (default: "https://api.graphql-hive.com/otel/v1/traces", env: HIVE_TRACE_ENDPOINT)
  --hive-persisted-documents-endpoint <endpoint>            [EXPERIMENTAL] Hive CDN endpoint for fetching the persisted documents. Requires the "--hive-persisted-documents-token <token>" option
  --hive-persisted-documents-token <token>                  [EXPERIMENTAL] Hive persisted documents CDN endpoint token. Requires the "--hive-persisted-documents-endpoint <endpoint>" option
  --hive-persisted-documents-cache-ttl <seconds>            [EXPERIMENTAL] TTL in seconds for cached persisted documents
  --hive-persisted-documents-cache-not-found-ttl <seconds>  [EXPERIMENTAL] TTL in seconds for negative cache entries (default: 60)
  --hive-cdn-endpoint <endpoint>                            Hive CDN endpoint for fetching the schema (env: HIVE_CDN_ENDPOINT)
  --hive-cdn-key <key>                                      Hive CDN API key for fetching the schema. implies that the "schemaPathOrUrl" argument is a url (env: HIVE_CDN_KEY)
  --apollo-graph-ref <graphRef>                             Apollo graph ref of the managed federation graph (<YOUR_GRAPH_ID>@<VARIANT>) (env: APOLLO_GRAPH_REF)
  --apollo-key <apiKey>                                     Apollo API key to use to authenticate with the managed federation up link (env: APOLLO_KEY)
  --disable-websockets                                      Disable WebSockets support
  --jit                                                     Enable Just-In-Time compilation of GraphQL documents (env: JIT) (env: JIT)
  -V, --version                                             output the version number
  --help                                                    display help for command

Commands:
  supergraph [options] [schemaPathOrUrl]                    serve a Federation supergraph provided by a compliant composition tool such as Mesh Compose or Apollo Rover
  subgraph [schemaPathOrUrl]                                serve a Federation subgraph that can be used with any Federation compatible router like Apollo Router/Gateway
  proxy [options] [endpoint]                                serve a proxy to a GraphQL API and add additional features such as monitoring/tracing, caching, rate limiting, security, and more
  help [command]                                            display help for command
Options (29)
OptionDescriptionSource
--fork numbernumber of workers to spawn.help
-c, --config-path pathpath to the configuration file.help
-h, --host hostnamehost to use for serving (default: 0.0.0.0) (env: HOST)help
-p, --port numberport to use for serving (default: 4000) (env: PORT)help
--polling durationschema polling interval in human readable duration (default: 10s) (env: POLLING)help
--render-legacy-graphiqlrender the legacy GraphiQL interface (default: false) (env: RENDER_LEGACY_GRAPHIQL)help
--no-masked-errorsdon't mask unexpected errors in responseshelp
--masked-errorsmask unexpected errors in responses (default: true)help
--opentelemetry exporter-endpointEnable OpenTelemetry integration with an exporter using this option's value as endpoint.help
--opentelemetry-exporter-type typeOpenTelemetry exporter type to use when setting up OpenTelemetry integration.help
--hive-registry-token token[DEPRECATED] please use "--hive-target" and "--hive-access-token" (env: HIVE_REGISTRY_TOKEN)help
--hive-usage-target target[DEPRECATED] please use --hive-target instead.help
--hive-target targetHive registry target to which the usage and tracing data should be reported to, and against which a dev supergraph source is composed remotely (see "--dev-remote").help
--hive-access-token tokenHive registry access token for usage metrics reporting and tracing.help
--hive-usage-access-token tokenHive registry access token for usage reporting.help
--hive-trace-access-token tokenHive registry access token for tracing.help
--hive-trace-endpoint endpointHive registry tracing endpoint.help
--hive-persisted-documents-endpoint endpoint[EXPERIMENTAL] Hive CDN endpoint for fetching the persisted documents.help
--hive-persisted-documents-token token[EXPERIMENTAL] Hive persisted documents CDN endpoint token.help
--hive-persisted-documents-cache-ttl seconds[EXPERIMENTAL] TTL in seconds for cached persisted documentshelp
--hive-persisted-documents-cache-not-found-ttl seconds[EXPERIMENTAL] TTL in seconds for negative cache entries (default: 60)help
--hive-cdn-endpoint endpointHive CDN endpoint for fetching the schema (env: HIVE_CDN_ENDPOINT)help
--hive-cdn-key keyHive CDN API key for fetching the schema.help
--apollo-graph-ref graphRefApollo graph ref of the managed federation graph (<YOUR_GRAPH_ID>@<VARIANT>) (env: APOLLO_GRAPH_REF)help
--apollo-key apiKeyApollo API key to use to authenticate with the managed federation up link (env: APOLLO_KEY)help
--disable-websocketsDisable WebSockets supporthelp
--jitEnable Just-In-Time compilation of GraphQL documents (env: JIT) (env: JIT)help
-V, --versionoutput the version numberhelp
--helpdisplay help for commandhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.