shelly discover http

Discover devices via HTTP subnet scanning

Synopsis

Discover Shelly devices by probing HTTP endpoints on a subnet.

If no subnet is provided, attempts to detect the local network. This method is slower than mDNS or CoIoT but works when multicast is blocked or devices are on different VLANs.

The scan probes each IP address in the subnet range for Shelly device HTTP endpoints. Progress is shown in real-time. Discovered devices can be automatically registered with –register.

Use –skip-existing (enabled by default) to avoid re-registering devices that are already in your registry.

Output is formatted as a table showing: ID, Address, Model, Generation, Protocol, and Auth status.

1
shelly discover http [subnet] [flags]

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
  # Scan default network (auto-detect)
  shelly discover http

  # Scan specific subnet
  shelly discover http 192.168.1.0/24

  # Scan a /16 network (large, use longer timeout)
  shelly discover http 10.0.0.0/16 --timeout 30m

  # Auto-register discovered devices
  shelly discover http --register

  # Using 'scan' alias
  shelly discover scan --timeout 5m

  # Force re-register all discovered devices
  shelly discover http --register --skip-existing=false

  # Combine flags for initial network setup
  shelly discover http 192.168.1.0/24 --register --timeout 10m

Options

1
2
3
4
  -h, --help               help for http
      --register           Automatically register discovered devices
      --skip-existing      Skip devices already registered (default true)
  -t, --timeout duration   Scan timeout (default 2m0s)

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)

Docs

Shelly CLI

Title here

shelly discover http