Skip to content

Connecting Nodes

A connection between two nodes (an edge) represents a real link — a network cable, a data path, a dependency. This is the “plumbing” of a diagram.

Every device has small connection handles — a dot on its top and bottom edges, always visible, and one on each side that appears when you hover over the device (or while you’re dragging a connection). To connect two devices:

  1. Hover over a device until you see its handles.
  2. Click and drag from one of its handles to a handle on another device.
  3. Release — a line now connects the two.

Any handle can be either end of a connection, so pick whichever sides make the line read cleanly: top-to-bottom for a hierarchy, side-to-side for peers. You can draw as many connections as you like between any two devices; a device can’t be connected to itself.

Select a connection and the toolbar at the top-right of the canvas offers three fields:

  • Label — free text, e.g. “uplink”, “replication”, “VLAN 20 trunk”.
  • Protocol and Port — e.g. HTTPS and 443.

Whatever you fill in is drawn on the line itself (replication · PostgreSQL/5432) and listed in the generated documentation’s connections table.

Schema colors connections automatically based on what they cross, so you can spot boundary crossings at a glance without styling anything yourself:

  • Blue — both ends of the connection are in the same zone or segment (or both are outside any container).
  • Orange — the connection crosses from one container into a different one, or from a container out to open canvas.
  • Gray — neither end belongs to a container at all.

You can always override the automatic color yourself — see Colors.

Click directly on a connection’s line to select it (its color toolbar appears, covered in Edge Styles). With it selected, press Delete or use the ribbon’s Delete button to remove it. Deleting a node also removes any connections attached to it.