Apollo Router
GraphOS Router - v1
OverviewAbout GraphOS RouterWhat's New in Router v1GraphOS Router FeaturesRouter ConfigurationRouter Request Lifecycle
Upgrade & Migrate
Upgrade from Router v0Migrate from Gateway
Self-Hosted Deployment
OverviewRouter Resource EstimatorHealth ChecksResource Management

Containerization

OverviewOptimize BuildsDocker

Kubernetes

QuickstartDeploying with ExtensibilityEnabling MetricsOther Considerations
Query Planning
Native Query Planner
Client Features
HTTP Header PropagationFile Upload Support

Real-Time Operations

OverviewDefer Support

Subscription Support

OverviewCallback ProtocolMultipart ProtocolEnable with API Gateway
Security
OverviewPersisted QueriesAuthorization

Authentication

JWT AuthenticationRouter AuthenticationSubgraph Authentication

Operations Security

Request LimitsDemand Control

Web Security

CORSCSRF Prevention
Observability
OverviewRouter TelemetryFederated Trace Data

Router Telemetry

Overview

Log Exporters

OverviewStdout

Metrics Exporters

OverviewDatadogDynatraceNew RelicOTLPPrometheus

Trace Exporters

OverviewDatadogDynatraceJaegerNew RelicOTLPZipkin

Instrumentation

InstrumentsEventsConditionsSpansSelectorsStandard AttributesStandard Instruments

Subgraph Observability

Subgraph Error InclusionDebugging Subgraph Requests

Client Observability

Debugging Client RequestsClient ID Enforcement

OpenTelemetry

Set up OTelConnect OTel to Prometheus
Performance and Scaling
OverviewTraffic ShapingQuery BatchingQuery Planner Pools

Caching

In-Memory CachingDistributed CachingEntity Caching
Router Customization
OverviewRhai ScriptsRust PluginsCoprocessorsCustom Binaries
GraphOS Integration
Apollo UplinkOperation Metrics Reporting
Guides
API Gateway Comparison
Products
Apollo GraphOS PlatformManage, observe, and scale your graph.Apollo ConnectorsConnect REST APIs to your graph declaratively.Apollo FederationFederate multiple subgraphs into a single supergraph.Rover CLIInteract with your graph from the command line.Apollo RouterRun and configure your graph gateway.Apollo OperatorDeploy and manage Apollo Router on Kubernetes.
Open source
Apollo Client (Web)Simplify GraphQL data management in web apps.Apollo iOSSwift-first GraphQL client for iOS.Apollo KotlinKotlin-first GraphQL client for Android and JVM.Apollo ServerBuild GraphQL servers with Node.js.Apollo MCP ServerExpose GraphQL tools to AI agents with MCP.IDE SupportEnhance your development workflow with IDE support.
Resources

GraphOS Router v1 is officially end-of-life as of 31 March 2026.

Learn more about upgrading.

Real-Time Operations

Configure the router for real-time operations

Responsive applications rely on the router to handle operations in real time. You can configure to support various real-time operations:

  • Subscriptions - support GraphQL subscription operations

  • Defer - use the @defer directive to enable incremental delivery of response data

  • File Uploads - upload files to the router using multipart HTTP requests