Reference
meteorcli
Device-plane CLI. Runs on managed Linux devices: configure the control plane, enroll, heartbeat, and keep an MQTT session.
Package details and install script: src/device-plane/agent/README.md.
Install
cd src/device-plane/agent
./installcli.sh # current user (~/.local)
sudo ./installcli.sh # system-wide
meteorcli --help
Config directory: ~/.config/meteorcli (or /etc/meteorcli as root).
Commands
| Command | Purpose |
|---|---|
config | Store control-plane domain / API base and enrollment API key |
test | Reachability + API key check |
register | Enroll with a registration token |
request-token | Device-initiated enroll; poll for approval |
claim | Fetch device token after a later approval |
run | Heartbeats + MQTT loop (--once for a single pass) |
status | Show non-secret local config |
mqtt-test / mqtt-listen | MQTT diagnostics |
Env overrides: METEORCLI_DOMAIN, METEORCLI_SERVER, METEORCLI_API_KEY, METEORCLI_TOKEN, METEORCLI_CONFIG_DIR.
--domain is the API host (no api. subdomain). IP/localhost uses HTTP; names default to HTTPS unless --http or --api-base / METEORCLI_SERVER is set.
Configure
meteorcli config --domain localhost:8000 --api-key key_...
meteorcli test
meteorcli config --show
Enroll
Registration token:
meteorcli register --server http://localhost:8000 --token-file /tmp/meteorcli.token --name edge-01
Device-initiated:
meteorcli request-token --name edge-01 # waits up to ~5 minutes (--wait)
# if still pending after approval later:
meteorcli claim
Then:
meteorcli run
meteorcli run --once