https://github.com/scanopy/scanopy
Network diagrams that update themselves
https://github.com/scanopy/scanopy
documentation documentation-generator documentation-tools homelab network-analysis network-diagram network-diagrams network-docs network-documentation network-mapper network-mapping-tool network-visualization network-visualizer networking self-hosted visualization
Last synced: 9 days ago
JSON representation
Network diagrams that update themselves
- Host: GitHub
- URL: https://github.com/scanopy/scanopy
- Owner: scanopy
- License: agpl-3.0
- Created: 2025-09-29T18:37:20.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-06-26T22:21:41.000Z (17 days ago)
- Last Synced: 2026-06-27T00:27:57.157Z (17 days ago)
- Topics: documentation, documentation-generator, documentation-tools, homelab, network-analysis, network-diagram, network-diagrams, network-docs, network-documentation, network-mapper, network-mapping-tool, network-visualization, network-visualizer, networking, self-hosted, visualization
- Language: Rust
- Homepage: https://scanopy.net
- Size: 64.1 MB
- Stars: 5,098
- Watchers: 23
- Forks: 244
- Open Issues: 46
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- Funding: .github/funding.yml
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
- awesome-github-repos - scanopy/scanopy - Network diagrams that update themselves (Rust)
- definitive-opensource - Scanopy
README
# Scanopy
**Network documentation, without the drawing.**
Scanopy replaces manual network diagrams with a continuously maintained model of what's actually running. A single daemon scans on a schedule and produces four views from each scan: L2 (physical), L3 (logical), workloads, and applications. Unlike diagrams drawn in draw.io that go stale the week they're saved, or IaC state that misses drift and resources provisioned outside the pipeline, Scanopy reflects the current state of your infrastructure. Export as SVG, Mermaid, or Confluence; embed live maps; or feed the model into your existing source of truth.
 
 
 
  
[](https://discord.gg/b7ffQr8AcZ) [](https://hosted.weblate.org/engage/scanopy/)
> 💡 **Prefer not to self-host?** [Get a free trial](https://scanopy.net?utm_source=github&utm_medium=readme&utm_campaign=cloud_trial) of Scanopy Cloud
L2 (Physical)
Every switch, every port, every link.
L3 (Logical)
Subnets and how hosts connect across them.
Workloads
Bare metal to hypervisors to containers.
Applications
Services and their dependencies, grouped by application.
## ✨ Features
- **Automatic discovery**: Maps hosts and services by scanning the network. One scanner, no per-device agents.
- **230+ service definitions**: Auto-detects databases, web servers, containers, network infrastructure, and enterprise applications.
- **Four views from one scan**: L2 (physical), L3 (logical), workloads, and application dependencies.
- **Distributed scanning**: Deploy daemons across segments to map multi-site and multi-VLAN topologies.
- **Docker & SNMP integration**: Native discovery for containerized services and network hardware.
- **Scheduled rescans**: Documentation stays current as infrastructure changes.
- **Multi-user + RBAC**: Organization management, role-based access, and shareable live views for teammates or external stakeholders.
## 🎯 Perfect For
- **Platform & DevOps teams**: Trace service dependencies without APM. Map containers, VMs, and hardware in one model.
- **Network engineers**: Multi-VLAN, multi-site topology diagrams derived from SNMP, LLDP, and ARP. No manual drawing.
- **IT operations**: Keep inventory, topology, and dependencies current across teams and sites.
- **MSPs**: Per-client documentation with shareable live views.
- **Home labs**: Document your infrastructure without opening draw.io.
## 📋 Licensing
**Self-hosted ([AGPL-3.0](LICENSE.md)):** Free for all use. Requires source disclosure for network services and copyleft compliance.
**Self-hosted ([Commercial license](COMMERCIAL-LICENSE.md)):** For those who cannot comply with AGPL-3.0 terms. Contact licensing@scanopy.net
**Hosted Solution:** **[Scanopy Cloud](https://scanopy.net?utm_source=github&utm_medium=readme&utm_campaign=cloud_trial)** subscription for zero infrastructure management
## 🚀 Quick Start for Self Hosting
**Docker Compose**
```bash
curl -O https://raw.githubusercontent.com/scanopy/scanopy/refs/heads/main/docker-compose.yml
docker compose up -d
```
**Proxmox**
Use this [helper script](https://community-scripts.github.io/ProxmoxVE/scripts?id=scanopy) to create a Scanopy LXC.
**Unraid**
Available as an Unraid community app.
> 💡 **Prefer not to self-host?** [Get a free trial](https://scanopy.net?utm_source=github&utm_medium=readme&utm_campaign=cloud_trial) of Scanopy Cloud
---
Access the UI at `http://:60072`, create your account, and wait for the first discovery to complete.
For detailed setup options and configuration, see the [Installation Guide](https://scanopy.net/docs/server-installation?utm_source=github&utm_medium=readme&utm_campaign=docs).
## 📚 Documentation + API
**[scanopy.net/docs](https://scanopy.net/docs?utm_source=github&utm_medium=readme&utm_campaign=docs)**
## 🚀 Demo
**[demo.scanopy.net](https://demo.scanopy.net/?utm_source=github&utm_medium=readme&utm_campaign=demo)**. Hosted demo app with a sample dataset. Try the full UI without installing anything.
## 🤝 Contributing
We welcome contributions! See our [contributing guide](contributing.md) for details.
Great first contributions:
- [Adding service definitions](contributing.md#adding-service-definitions)
- [Translating Scanopy](https://hosted.weblate.org/engage/scanopy/) into your language
## 💬 Community & Support
- **Discord**: [Join our Discord](https://discord.gg/b7ffQr8AcZ) for help and discussions
- **Issues**: [Report bugs or request features](https://github.com/scanopy/scanopy/issues/new)
- **Discussions**: [GitHub Discussions](https://github.com/scanopy/scanopy/discussions)
---
**Translations powered by Weblate**
**Built with ❤️ in NYC**