Browse documentation
Creating a network diagram
↩ Diagrams
Network diagrams let you draw how your infrastructure connects, using real devices and servers from your inventory as nodes. This article covers building one.
Creating a diagram
- Select Diagrams in the sidebar, then New diagram.
- Give it a Name, choose a Type (for topology, pick Topology), optionally assign a Site and Groups, and add a Description.
- Create it to open the editor.
Adding nodes
In the editor (Edit mode), use the node picker to place elements:
- Server, Device, or Service — pick from your inventory. These nodes show a live status dot; items already on the canvas are greyed out in the picker.
- Label — free-text annotation.
- Image — upload a custom icon or graphic.
- Rack — an equipment enclosure (see Building a rack diagram).
For a Topology diagram tied to a site, Auto-populate pulls in all that site's servers, devices, and services and lays them out for you as a starting point.
Connecting nodes
Drag from a node's handle (top, bottom, left, or right) to another node to draw a connection. Select a connection to label its source and target interfaces (e.g. Gi0/1 → eth0).
Editing and layout
- Select a node to edit its label, sublabel, image, and (for devices) port count.
- Drag to reposition; resize with the corner handles.
- Pan with the mouse wheel, zoom with Ctrl+scroll, and use the mini-map to navigate.
- Delete a selected node or connection with Delete/Backspace.
Saving and exporting
Select Save to store the diagram. You can Export it to PNG or PDF, and switch between Edit and View modes with the toggle.
Notes & tips
- Because nodes are real inventory items, a topology diagram doubles as a live status board — see Live status on diagrams.
- Assign the diagram to a Site so Auto-populate has a set of equipment to pull from.