Wheelhouse docs

Network#

Fifteen jobs, in three groups: making an interface exist, deciding where packets go, and using more than one way out.

Interfaces#

GuideThe job
Add a VLANA tagged sub-interface on a physical port
Bridge two portsOne layer-2 segment across two NICs
Bond two portsTwo NICs, one logical link, 802.3ad
A PPPoE uplinkThe addressing most DSL and some fibre providers use
GRE, IPIP, SIT and VXLAN interfacesTunnel interfaces, and what each is for

Where packets go#

GuideThe job
Add a static routeA prefix, a next hop, and a distance
Shape a link with CAKEEgress shaping, and what the editor can and cannot express
A BGP sessionOne neighbour, one AS
An OSPF areaAn area and the interfaces in it
IPv6: what is configurable and what is not observableThe honest state of IPv6 here

More than one way out#

An uplink is any interface that carries a default route — VyOS has no gateway object. The Uplinks tab finds them through all five mechanisms and joins them with the live forwarding table.

GuideThe job
A second uplink with health-checked failoverThe one most people want
Share load across two uplinksNew connections spread by weight
Send one subnet out a chosen uplink"The cameras go out through LTE"
Masquerade behind each uplinkOne source NAT rule per uplink
Two routers, one virtual addressVRRP, and what it does and does not give you

Checked against docs/multi-wan.md · agent/wan.go · ui/src/pages/Interfaces.tsx · ui/src/pages/Wan.tsx

Updated 2026-09-02 network interfaces routing