mayros iot

Manage the fleet of aingle_minimal IoT nodes connected via the iot-bridge plugin. Add, remove, inspect, and ping edge devices from the command line.

Subcommands

iot fleet

List all IoT nodes registered in the fleet with their connection status.

Displays a table with node ID, host, port, online/offline status, and label. Also shows aggregate online/offline counts.

iot add <host>

Add a new IoT node to the fleet. After adding, an immediate health check is performed to verify connectivity.

OptionDescription
--port <port>Node port (default: 8080)
--id <id>Node ID (defaults to host with dots replaced by hyphens)
--label <label>Human-friendly label for the node

iot remove <id>

Remove an IoT node from the fleet by its ID. The node is also removed from the persisted fleet file.

iot status <id>

Show detailed status for a specific IoT node. Includes connection info, version, uptime, entry/peer counts, storage backend, features, actions, gossip rounds, sync stats, and connected peers with quality metrics.

iot ping <id>

Quick health check for a node. Returns PONG with latency in milliseconds if the node is reachable, or UNREACHABLE otherwise.

Examples

bash
mayros iot fleet
mayros iot add 192.168.1.50 --port 8080 --label "Living room sensor"
mayros iot add sensor.local --id my-sensor --label "Garden node"
mayros iot remove my-sensor
mayros iot status 192-168-1-50
mayros iot ping 192-168-1-50