shelly zigbee pair On this page shelly zigbee pair# Start Zigbee network pairing
Synopsis# Start Zigbee network pairing on a Shelly device.
This initiates the network steering process, causing the device to
search for and attempt to join a Zigbee network. The coordinator
(e.g., Home Assistant ZHA, Zigbee2MQTT) must be in pairing mode.
The command enables Zigbee if not already enabled, then starts
network steering. Use –timeout to specify how long to wait for
the device to join a network.
1
shelly zigbee pair <device> [flags]
Examples# 1
2
3
4
5
# Start pairing with default 180s timeout
shelly zigbee pair living-room
# Start pairing with custom timeout
shelly zigbee pair living-room --timeout 60
Options# 1
2
-h, --help help for pair
--timeout int Pairing timeout in seconds (default 180)
Options inherited from parent commands# 1
2
3
4
5
6
7
8
9
10
11
12
--config string Config file (default $HOME/.config/shelly/config.yaml)
--log-categories string Filter logs by category (comma-separated: network,api,device,config,auth,plugin)
--log-json Output logs in JSON format
--no-color Disable colored output
--no-headers Hide table headers in output
--offline Only read from cache, error on cache miss
-o, --output string Output format (table, json, yaml, template) (default "table")
--plain Disable borders and colors (machine-readable output)
-q, --quiet Suppress non-essential output
--refresh Bypass cache and fetch fresh data from device
--template string Go template string for output (use with -o template)
-v, --verbose count Increase verbosity (-v=info, -vv=debug, -vvv=trace)
SEE ALSO#