Staex logostaexDocs
Docs/Network Topology

Network Topology

Set up Staex MCC networks with different topologies: tree and linear configurations.

Overview#

Staex MCC supports several network topologies to fit different deployment requirements. Nodes connect to the network through parent nodes, and the arrangement of these parent-child relationships determines the overall topology.

Tree Topology#

In a tree topology, multiple nodes point to the same parent. This is the most common configuration and works well for centralized deployments:

bash
# Node A
sudo mcc init --parents public.staex.io <NETWORK-CERTIFICATE-BASE64>

# Node B sudo mcc init --parents public.staex.io <NETWORK-CERTIFICATE-BASE64>

Both nodes register with the same parent (public.staex.io), forming a tree where the public network acts as the root.

Linear Topology#

In a linear topology, nodes are chained together: each node connects to the previous one as its parent.

bash
# First node connects to the public network
sudo mcc init --parents public.staex.io <NETWORK-CERTIFICATE-BASE64>

# Second node connects to the first node sudo mcc init --parents <FIRST_NODE_IP>:9376 <NETWORK-CERTIFICATE-BASE64>

This configuration is useful when nodes are physically distributed and only have line-of-sight connectivity to their immediate neighbor.

Multi-hop Networking#

Staex MCC ensures global connectivity even when a child node can only reach its immediate parent. Traffic is automatically forwarded through the chain of parent nodes until it reaches the destination. You can chain-link nodes to build multi-hop networks that span geographically dispersed locations, enabling communication between endpoints that have no direct path to each other.