Staex logostaexDocs
Docs/DNS Configuration

DNS Configuration

Configure the built-in DNS service to assign human-friendly names to MCC network nodes.

Overview#

MCC ships with a built-in DNS resolver that maps tunnel names and node names to network addresses. The resolver uses a configurable domain suffix -- the default is .home.arpa, but it is commonly set to .staex for convenience.

Naming Network Nodes#

To assign a human-readable DNS name to a node, edit the main configuration file and set:

  • resolver.domain = .staex to define the domain suffix
  • dns-names = node1 to assign a name to the current node
After restarting MCC, other nodes on the network can reach this node at node1.staex.

Naming Tunnels#

Tunnels can also receive DNS names. In the tunnel configuration file, set:

  • dns-names = light1
The server endpoint of that tunnel becomes accessible as light1.staex from any node on the network.

DNS Server Details#

MCC runs a local DNS server that listens on port 8353 by default. To make the .staex domain resolvable system-wide, configure your system DNS or a local forwarder (such as dnsmasq or systemd-resolved) to forward queries for the configured domain to 127.0.0.1:8353.