Skip to content

Open-source freedom for network operations.

Topology you
can trust.

Generate network diagrams from YAML and real infrastructure data. Embed them in documentation or use them for daily operations and monitoring.

Deploy it yourself, or work with us on deployment and integrations. Talk to us

Explore the features
Topology viewer with live weathermap
Shumoku Server — topology and live traffic
Used by teams in production environments
電気通信大学 情報基盤センターJANOG57

In production

Topology viewer with live weathermap

Live traffic overlay — JANOG57 NOC

NOC dashboard

NOC dashboard — JANOG57

“Replaced static topology diagrams with auto-generated live topology. Used in production for JANOG57 NOC. Streamed on NOC Live.”

NOC BB Team — JANOG57

“Campus network monitoring with Zabbix. Live weathermaps running within a day.”

Infrastructure Team — University NOC

Features

Live weathermap

Traffic utilization on links, color-coded by load

Live weathermap with traffic tooltip

Alert overlay

Active alerts from Zabbix, Prometheus, Grafana on topology

Alert overlay on topology

NetBox auto-generation

Devices and cables pulled directly from NetBox

NetBox topology source configuration

900+ vendor icons

Yamaha, Aruba, AWS, Juniper — correct aspect ratios

Vendor icons rendered at correct aspect ratios

Interactive navigation

Pan, zoom, multi-layer drill-down in the browser

Pan and zoom controls

Shareable links

Public topology views with a token — no login required

Share link dialog

Network discovery

Crawl your network via SNMP + LLDP from a seed device. No inventory required.

Custom layout engine

Purpose-built hierarchical layout engine for network diagrams. No generic graph library.

Integrations

Topology Sources
YAML built-in

Define topology as code

NetBox plugin

Auto-discover from DCIM/IPAM

Network scan plugin

Discover topology via SNMP + LLDP from a seed device

Shumoku
Shumoku

Topology visualization from your infrastructure

Monitoring Sources
Zabbix plugin

Traffic, host status, alerts

Prometheus plugin

SNMP & node exporter metrics

Grafana plugin

Webhook alerts

Aruba Instant On plugin

Hosts, metrics, and alerts from the Instant On portal

Custom API plugin

Your own data source

The Shumoku stack

Shumoku is not only a server. It is a set of libraries, renderers, tools, and apps for turning infrastructure data into maps you can operate from.

Core

Models, parsers, layout, themes, plugin types, and shared helpers. The renderer-agnostic foundation used across Shumoku.

Core docs →

CLI / npm packages

Render YAML or JSON topology to SVG, interactive HTML, or PNG for Markdown, documentation, CI, and product embedding.

CLI docs →

Server

A self-hosted operations app for topology management, live metrics, alert overlays, dashboards, and read-only share links.

Server docs →

Editor

A visual design tool for physical topology, devices, modules, cables, project files, BOM, and PoE analysis.

Open Editor →

Start using Shumoku

Open Source
Run the public Docker image
Open localhost:8080 and set an admin password
Import YAML or connect NetBox
Add monitoring data sources when you need live status
Commercial support
  • Deployment and operations support
  • Data source integration assistance
  • Environment-specific topology and metric mapping
  • Custom plugin development and priority work

Around Shumoku

A toast together at the venue. A toast together at the venue.

Event report · 2026.09.08

写真で振り返る Shumoku Meetup #1

2026年9月8日、さくらインターネット東京支社で開催したShumoku Meetup #1。受付から登壇、交流までを写真で振り返ります。

Join the community

Questions, events and contributions. Find your way in as a user or a contributor.

FAQ

Is it free?

Shumoku is open source under AGPL-3.0 — free to use, no commercial contract required. We offer paid support, consulting, and custom development for production deployments.

Can AGPL-3.0 be used commercially?

Yes, as long as you follow the AGPL-3.0 terms. Commercial support does not change the software license. If AGPL does not fit your situation, contact us to discuss it.

How is it different from PHP Weathermap?

Shumoku is topology-first: multi-layer navigation, 900+ vendor icons, native data-source plugins, alerts, dashboards, and sharing without requiring Grafana.

Can I use it without monitoring tools?

Yes. Use YAML, NetBox, network scan, or a custom plugin as a standalone topology viewer. Monitoring integrations are optional.

Can I use it without NetBox?

Yes. YAML definitions, SNMP + LLDP network scan, Zabbix LLDP topology, and custom plugins are all supported paths.

What is the difference between Server and Editor?

Server is the self-hosted operations and monitoring app. Editor is the visual design tool for physical topology, devices, modules, cables, BOM, and PoE analysis.

What about commercial support?

Public bug reports, questions, and feature requests are community support on GitHub. Investigating your specific environment, private support with guaranteed response, deadline-bound work, and custom development are commercial — reach us at contact@shumoku.dev. Commercial support is delivered together with our non-exclusive partner TelHi Corporation (輝日株式会社); there is no sole official reseller of Shumoku.

See the commercial support section →