Skip to content

Docker & Self-Hosting

WhyGraph ships as a self-contained image, so there are two ways to run it. Both use the same image; they differ in who's driving.

  • As a local dev tool


    Install the Docker shim, then init and scan your repos and wire your editor - no Python or Node on the host. This is the default install.

    Run with Docker

  • As a service


    A containerized whygraph-mcp endpoint that real applications - not just editors - connect to for git-based analysis of a target repo.

    WhyGraph as a service

Most people start with the local tool. Reach for the service model when you're building an application that needs the why behind code - a review bot, an onboarding assistant, an internal portal.