Docs/Adding IP Devices

Adding IP Devices

Integrate IP-based IoT devices into the Staex MCC network without installing VPN software on them.

Overview#

Many IoT devices -- IP cameras, smart meters, network printers, and industrial sensors -- communicate over IPv4 but cannot run VPN client software. Staex MCC tunnels allow you to securely connect these devices to your network without any software changes on the device itself. This feature is available on Linux only.

Create a Tunnel for an IP Device#

To bring an IP device into the MCC network, create a tunnel that references the device's local IPv4 address:

bash

mcc create-tunnel --remote-node <NODE_ID> --targets tcp:80 --external-ip-address x.x.x.x

Replace x.x.x.x with the device's local IPv4 address on the LAN. This command generates the necessary configuration files under /etc/mcc/tunnels.

Activate and Verify#

The tunnel activates automatically without requiring a service restart. Verify that the device is visible on the network:

bash

mcc nodes

The output should list both the server and client endpoints of the tunnel, confirming the device is reachable.

Access the Device#

From any other node in the MCC network, use the device's node ID (shown in the mcc nodes output) as a DNS name. This lets you reach the device transparently, as if it were a regular host on the same network.

Network Topology

DNS Configuration