NetBox Diagram

Automatically generated, up-to-date network diagrams from NetBox

📑 Table of Contents

• Overview
• Key Features
• Installation
• Quick Demo
• Screenshots

Overview

netbox_diagram is a plugin for NetBox that enables the creation and management of network diagrams using NetBox devices and circuits. It renders physical and logical interconnections (e.g., cables, circuits) between devices based on their coordinates and metadata.

Key Features

• Group devices into diagrams
• Automatically render cables and circuits
• Position devices using X/Y coordinates
• Asynchronous updates for fast performance
• Toggle grid and link labels for clarity

❗ Limitations:

• No support for virtual machines
• Power connections and patch panels are not visualized

For more advanced or flexible diagramming, consider:

• NextBox UI Plugin
• NetBox Topology Views Plugin

🔧 Installation

1. Install via pip

pip install netbox_diagram

2. Enable the plugin in configuration.py

PLUGINS = [
    'netbox_diagram',
    # other plugins...
]

3. Apply migrations and collect static files

python3 manage.py migrate
python3 manage.py collectstatic

4. Restart NetBox

sudo systemctl restart netbox

🚀 Quick Demo

Want to try it out quickly? Use the provided demo script to set up a sample environment. A running Netbox instance is required though!

This will:

• Create 5 devices
• Connect 2 devices via a circuit
• Simulate patch panels via front-back port connections
• Connect 4 devices to one central device
• Generate a diagram including all devices

Run the demo

📌 Requires a running NetBox instance with API access enabled.

Update NETBOX_HOST and API_TOKEN to match your environment. (it obviously should point to your Netbox and use a API Token you've generated). The script itself has no external dependencies, you can run it straight away.

export NETBOX_HOST="172.16.123.1:8001"
export API_TOKEN="your_token_here"
python3 setup_demo.py

📸 Screenshots

Diagram overview with name, description, and associated objects:

Final generated diagram (patch panels not shown):

Diagram with link labels disabled:

Diagram with grid enabled:

New "Diagrams" tab on Device and Circuit detail pages: