Skip to main content
Version: Beta

Run Your First Discovery

Discovery is how Devgraph automatically finds and maps your infrastructure. Let's discover your GitHub repositories.

What is Discovery?

Discovery providers scan external systems (GitHub, GitLab, Argo, etc.) and create entities in your Devgraph ontology. Each provider:

  • Connects to an external API or system
  • Finds resources (repos, projects, deployments, etc.)
  • Creates entities and relationships in the Ontology
  • Continues to automatically discover these resources and apply any changes to the Ontology

How can I run Discovery?

Discovery may be configured and run within the Devgraph platform, or by running the Devgraph discovery process locally. Each of these modes provides the same capabilities, and choosing one mode over the other is simply a matter of preference.

Platform Discovery

Configure and run discovery directly in the Devgraph platform through the web interface. This is the easiest way to get started.

Learn more about platform discovery →

Local Discovery

Run discovery locally using a YAML configuration file. This approach is ideal for automation, CI/CD pipelines, and advanced configurations.

Learn more about local discovery →

Next Steps

After setting up discovery:

  1. Learn about entity types and relationships
  2. Explore the Molecules Overview to add more integrations