Skip to content
SHC Docs

Layer 0. Underlay

Layer 0. Underlay. Layer page.

The underlay is the host address a node is dialled at. mesh0 and shc0 both use it, so neither tunnel carries the other.

The underlay waits on the edge deployment and on nothing else above it. Everything a joiner asks a member before it enrols goes through the edge on TCP 443 (ruling D1, register row A-07).

The node row stores UnderlayAddress and Location (ce modules/node/models.go). A mesh peer’s Endpoint is that underlay address, read from the node row (ce modules/mesh/mesh.go). WithUnderlay records the address as a /32 when address planning needs it (ce core/addrblock/networks.go).

mesh0 listens on UDP 4244 and shc0 on UDP 4243 (ce core/nodeports/ports.go). Enrolment is a separate TCP path; see Mesh.

The three underlay functions a joiner calls before it enrols, underlay.members, underlay.probe.arm and underlay.probe.result, are served only on the public join route through the edge (ce modules/underlay/rpc.go, modules/underlay/pairs_rpc.go).

Ruled, not on this pin: a node-plane device other than mesh0.