netbox-drawio

Draw network diagrams inside NetBox and link one diagram to many objects.

NetBox plugin for creating draw.io diagrams directly in NetBox and assigning them to multiple NetBox objects (Devices, Sites, Circuits, …).

A topology diagram usually touches many objects — unlike a per-object attachment, one Diagram here can be linked to every Device and Site it depicts.

Screenshots

The Diagrams tab on a Device, with SVG preview cards:

The draw.io editor embedded in NetBox:

Features

• Embedded draw.io editor — edit diagrams in an iframe using the draw.io embed protocol. Diagram XML travels only between your browser and NetBox; the editor host never receives it.
• Diagrams tab on object detail pages (like the Images feature) with SVG preview cards, per-card edit and unlink actions, and Add Diagram / Link Existing buttons.
• Many-to-many assignment — link one diagram to any number of objects of any enabled type.
• SVG previews served from a hardened endpoint (CSP, sandbox, nosniff; rendered via <img> so embedded scripts can never execute).
• .drawio source download, REST API for diagrams and assignments, global search, change logging (content blobs are excluded; a content_hash records every content change), tags, custom fields, journaling, and object permissions.

Compatibility

Python ≥ 3.12, < 3.15.

Installation

pip install netbox-drawio       # or: pip install -e /opt/drawio-netbox-plugin

configuration.py:

PLUGINS = [
    # ...
    "netbox_drawio",
]

python manage.py migrate netbox_drawio
python manage.py collectstatic --no-input
# restart NetBox services

Configuration

All settings are optional (PLUGINS_CONFIG["netbox_drawio"] = {...}):

Self-hosted draw.io

PLUGINS_CONFIG = {
    "netbox_drawio": {
        "drawio_base_url": "https://drawio.example.com/",
        "drawio_url_params": {"ui": "min", "dark": "auto"},
    },
}

Usage

1. From an object: open e.g. a Device → Diagrams tab → Add Diagram (creates the diagram already linked to the device) or Link Existing.
2. Draw: on the diagram page click Edit Diagram — the embedded editor opens. Press the editor's Save button to store the XML and refresh the SVG preview. Exit returns to NetBox.
3. Link more objects: diagram page → Assign to Object (or link from any object's tab). Unlinking never deletes the diagram.

REST API

• /api/plugins/drawio/diagrams/ — CRUD incl. source_xml / svg_cache. The list response intentionally omits both blob fields (they can reach max_size per row); retrieve a diagram by id to get them. ?brief=true is unaffected.
• /api/plugins/drawio/diagram-assignments/ — object_type as "app.model", e.g. {"diagram": 1, "object_type": "dcim.device", "object_id": 42}

Development

/opt/netbox/venv/bin/python /opt/netbox/netbox/manage.py test netbox_drawio --keepdb

Support

Bug reports and feature requests: GitHub Issues.

License

Apache-2.0 — see LICENSE. Copyright 2026 CESNET z.s.p.o.