| stage | Orbit |
|---|---|
| group | Context Systems |
| info | To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments |
| description | GitLab Orbit running on GitLab-hosted infrastructure |
| title | GitLab Orbit Remote |
{{< details >}}
- Tier: Premium, Ultimate
- Offering: GitLab.com
- Status: Beta
{{< /details >}}
{{< history >}}
- Introduced in GitLab 18.10 with a feature flag named
knowledge_graph. Disabled by default. This feature is an experiment. - Changed to beta in GitLab 19.1.
{{< /history >}}
[!flag] The availability of this feature is controlled by a feature flag. For more information, see the history. This feature is available for testing, but not ready for production use.
GitLab Orbit Remote runs on GitLab-hosted infrastructure. Enable it on a top-level group and it automatically indexes your entire SDLC and code - groups, projects, users, merge requests, pipelines, vulnerabilities, and source code - into a ClickHouse property graph.
- Indexes: Full SDLC + code graph
- Storage: ClickHouse (managed, no setup required)
Get started with GitLab Orbit Remote
| Page | Description |
|---|---|
| Get started | Enable GitLab Orbit and run your first query |
| How it works | Indexing pipeline, graph model, query execution |
| What GitLab Orbit indexes | SDLC coverage, language support, indexing scope |
| Security | Roles required to query, the authorization model, programmatic access, and service accounts |
| Schema reference | All 28 node types across 6 domains |
| Cookbook | Copy-paste queries for common use cases |
| Query language | Full query DSL reference |
| Method | Description |
|---|---|
| GitLab Duo Agent Platform | Natural language questions via the GitLab UI |
| MCP | Connect Claude Code, Codex, and other agents |
The GitLab CLI (glab) |
glab orbit for scripting and discovery (available in glab 1.117 or later) |
| REST API | Query from scripts, CI pipelines, or custom tooling |
During the beta, GitLab Orbit queries do not consume GitLab Credits.
When GitLab Orbit is generally available, queries consume GitLab Credits. Credit rates are published in GitLab Credits and usage billing before charging begins.