Quick Start

Before getting started, ensure that you have:

• A machine running Debian or Ubuntu Linux
• An active internet connection
• UDP traffic not blocked by your firewall or network policies

Navigate to cas.staex.io and use the self-service portal to create a new network certificate. During the process you will be issued a private key and a certificate in BASE64 format. Save both securely -- you will need the private key during initialization and the certificate to configure your nodes.

Install MCC from the official Staex package repository:

curl -o /tmp/staex-repo.noarch.deb https://packages.staex.io/linux/deb/staex-repo.noarch.deb
sudo apt-get install /tmp/staex-repo.noarch.deb
sudo apt-get update
sudo apt-get install mcc

Run the initialization command, passing the public Staex network as the parent along with your network certificate:

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

The command will prompt you to enter the network private key. Paste it when asked. Once initialization completes, enable and start the MCC service:

sudo systemctl enable --now mcc

Inspect the service logs to confirm that everything is running correctly:

sudo journalctl -u mcc

In a successful setup you should see entries showing your node ID, a connection to the parent node, and periodic certificate updates.

Create a tunnel to another node on the network. Replace with the target node's identifier:

sudo mcc create-tunnel --role client --name hello --remote-node <NODE_ID>

Resolve the tunnel name to an address and access the remote service:

mcc resolve hello
curl http://hello.staex:8090

The resolve command translates the tunnel name into a network address. After resolution, you can reach the remote endpoint using the .staex domain just like a local service.