{"id":30776149,"url":"https://github.com/graphql-hive/router","last_synced_at":"2026-05-11T17:04:14.008Z","repository":{"id":312727309,"uuid":"891604244","full_name":"graphql-hive/router","owner":"graphql-hive","description":"Open-source (MIT) GraphQL Federation Router. Built with Rust for maximum performance and robustness.","archived":false,"fork":false,"pushed_at":"2026-04-27T14:39:31.000Z","size":6384,"stargazers_count":86,"open_issues_count":65,"forks_count":9,"subscribers_count":4,"default_branch":"main","last_synced_at":"2026-04-27T15:07:46.514Z","etag":null,"topics":["apollo-federation","federation","federation-gateway","graphql","graphql-federation","router"],"latest_commit_sha":null,"homepage":"https://the-guild.dev/graphql/hive/docs/router","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/graphql-hive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE_MIT","code_of_conduct":null,"threat_model":null,"audit":"audits/.gitignore","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-20T16:16:12.000Z","updated_at":"2026-04-27T14:41:31.000Z","dependencies_parsed_at":"2025-09-01T17:33:17.161Z","dependency_job_id":"c60da02b-8c49-445c-bc4b-8a1295ac64e3","html_url":"https://github.com/graphql-hive/router","commit_stats":null,"previous_names":["graphql-hive/router"],"tags_count":199,"template":false,"template_full_name":null,"purl":"pkg:github/graphql-hive/router","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphql-hive%2Frouter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphql-hive%2Frouter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphql-hive%2Frouter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphql-hive%2Frouter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/graphql-hive","download_url":"https://codeload.github.com/graphql-hive/router/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/graphql-hive%2Frouter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32343571,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apollo-federation","federation","federation-gateway","graphql","graphql-federation","router"],"created_at":"2025-09-05T04:12:25.579Z","updated_at":"2026-04-27T16:00:49.156Z","avatar_url":"https://github.com/graphql-hive.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Hive GraphQL Platform](https://the-guild.dev/graphql/hive/github-org-image.png)\n\n# Hive Router (Rust)\n\nA fully open-source MIT-licensed GraphQL API router that can act as a [GraphQL federation](https://the-guild.dev/graphql/hive/federation) Router, built with Rust for maximum performance and robustness.\n\n\u003e [!TIP]\n\u003e 🚀 [Blog post: Welcome Hive Router](https://the-guild.dev/graphql/hive/blog/welcome-hive-router)\n\u003e\n\u003e Interested in the benchmark results? Check out the [Federation Gateway Performance comparison](https://the-guild.dev/graphql/hive/federation-gateway-performance)\n\nIt can be run as a standalone binary or a Docker Image. Query planner can be used as a standalone Crate library.\n\n[Binary Releases](https://github.com/graphql-hive/router/releases) | [Docker Releases](https://github.com/graphql-hive/router/pkgs/container/router) | [Documentation](https://the-guild.dev/graphql/hive/docs/router)\n\n## Try it out\n\nDownload Hive Router using the following install script:\n\n```\ncurl -o- https://raw.githubusercontent.com/graphql-hive/router/main/install.sh | sh\n```\n\n\u003e At the moment, only Linux runtimes are supported using a binary, see Docker option below if you are using a different OS.\n\nCreate a simple configuration file that points to your supergraph schema file:\n\n```yaml\n# router.config.yaml\nsupergraph:\n  source: file\n  path: ./supergraph.graphql\n```\n\nAlternativly, you can use environment variables to configure the router:\n\n```env\nSUPERGRAPH_FILE_PATH=./supergraph.graphql\n```\n\nThen, run the router:\n\n```bash\n# By default, \"router.config.yaml\" is used for configuration. Override it by setting \"ROUTER_CONFIG_FILE_PATH=some-custom-file.yaml\"\n# If you are using env vars, make sure to set the variables before running the router.\n./hive_router\n```\n\n### Binary\n\nSee [GitHub Releases](https://github.com/graphql-hive/router/releases) to the full list of release and versions.\n\n### Docker\n\nThe router image is being published to [Docker to GitHub Container Registry](https://github.com/graphql-hive/router/pkgs/container/router). You may use it directly using the following command:\n\n```bash\ndocker run \\\n  -p 4000:4000 \\\n  -e SUPERGRAPH_FILE_PATH=\"/app/supergraph.graphql\" \\\n  -v ./my-supergraph.graphql:/app/supergraph.graphql \\\n  ghcr.io/graphql-hive/router:latest\n```\n\n\u003e Replace `my-supergraph.graphql` with a local supergraph file.\n\nAlternativly, you can mount the configuration file using `-v` and pass all other configurations there:\n\n```bash\ndocker run \\\n  -p 4000:4000 \\\n  -v ./router.config.yaml:/app/router.config.yaml \\\n  ghcr.io/graphql-hive/router:latest\n```\n\n\u003e Replace `latest` with a specific version tag, or a pre-release for one of the PRs (`pr-\u003cnumber\u003e` or `sha-\u003ccommit-sha\u003e`).\n\n\u003e To try the query planner, see [bin/dev-cli/README.md](bin/dev-cli/README.md) for instructions to quickly use the qp-dev-cli for seeing the QP in action.\n\n## Local Development\n\n- Run `cargo test_all` to execute all unit tests.\n- Run `cargo test_e2e` to execute all e2e tests.\n- Run `cargo test_qp` to execute all query planner tests.\n- Run `cargo test_qpe` to execute all plan executor tests.\n- See [lib/query-planner/README.md](lib/query-planner/README.md) for more information, logging and configuration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraphql-hive%2Frouter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgraphql-hive%2Frouter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgraphql-hive%2Frouter/lists"}