# Netdryrun

<!-- facts:llms_summary -->
> Netdryrun is an open-source tool (Python, Apache-2.0) that tests network changes in a real containerlab virtual lab before they reach production. It waits for convergence, checks BGP sessions, prefixes, routes and reachability, and returns a pass/fail verdict with evidence. Supported network OSes: FRR, Nokia SR Linux, SONiC (docker-sonic-vs) and Arista EOS (cEOS, bring your own image). It runs locally, in GitHub Actions, or as an MCP server for AI agents.

Install: `pipx install netdryrun` (or `uv tool install netdryrun`; current version 0.3.1). Source: https://github.com/netdryrun/netdryrun

Facts (generated from the source): version 0.3.1; check types `bgp_session`, `bgp_prefixes`, `route`, `bgp_route` and `ping`; MCP tools `dry_run`, `run_checks`, `record_baseline`, `validate` and `check_types`; verdict corpus Netdryrun 24/30, ping-only 20/30, sessions-up 15/30.
<!-- /facts:llms_summary -->

## Docs

- [Overview](https://netdryrun.com/): what it does, a failing example, the GitHub Action
- [Getting started](https://netdryrun.com/getting-started/): requirements, install, the examples
- [netdryrun.yml reference](https://netdryrun.com/reference/config/): every check type and key, convergence semantics
- [CLI and reports](https://netdryrun.com/reference/cli/): commands, flags, exit codes, JSON/Markdown/JUnit reports
- [GitHub Action](https://netdryrun.com/github-action/): inputs, outputs, security notes
- [Test an FRR change in CI](https://netdryrun.com/guides/frr-ci/): the lab folder, the checks that matter for FRR, a GitHub workflow, gotchas, measured times
- [Test a SONiC change in CI](https://netdryrun.com/guides/sonic-ci/): getting docker-sonic-vs, configuring it after boot with setup lines, the checks that matter for SONiC, gotchas, measured times
- [AI agents (MCP)](https://netdryrun.com/ai-agents/): MCP server tools and safety model

## Optional

- [When to use what](https://netdryrun.com/when-to-use-what/): Batfish, pyATS/Genie, containerlab and Netdryrun compared
- [Batfish, then Netdryrun](https://netdryrun.com/batfish/): a two-stage gate on FRR configs, with measured results and what each stage caught
- [Trust and security](https://netdryrun.com/trust/): license, releases, security contact, limits, privacy
<!-- facts:llms_corpus -->
- [Verdict corpus](https://netdryrun.com/corpus/): 30 realistic BGP changes with pre-registered verdicts; Netdryrun 24/30, ping-only 20/30, sessions-up 15/30 correct
<!-- /facts:llms_corpus -->
- [How it's built](https://netdryrun.com/how-its-built/): AI agents write most of the code; how results are checked, with evidence links; what is not claimed

## Full documentation

- [llms-full.txt](https://netdryrun.com/llms-full.txt): every docs page in one file
