Sign in
Nodes

Make a member the mesh hub, or remove the hub (ADR 048 D4). The hub relays traffic between members that cannot reach each other, so it sees that traffic: pick one of your own machines.

Changed on
put/nodes/wireguard/hub

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/nodes/wireguard/hub
  • Auth: HTTP bearer

Request body

Response

Hub set; current state

can_enableboolean required

Whether POST /nodes/wireguard can turn the mesh on here.

cidrstring nullable

Mesh address pool, when enabled.

enable_blockerstring nullable

What prevents enabling it, when can_enable is false and the mesh is off. Rendered verbatim.

enable_commandstring required

CLI equivalent of enabling, for the control-plane host.

handshake_errorstring nullable

Why handshake data is missing, when it is.

join_urlstring nullable

The configured external URL: what temps join should point at. null when none is configured.

listen_portinteger required

UDP port every node must accept from the others — the configured one even while the mesh is off, so it can be opened in advance.

reasonstring nullable

Why the mesh is not ready, when it is not. Rendered verbatim.

state'disabled' | 'starting' | 'ready' required

Whether the cluster's mesh is carrying traffic.

Changes