shelly doctor

shelly doctor

Check system health and diagnose issues

Synopsis

Run comprehensive diagnostics on the Shelly CLI setup.

Checks include:

  • CLI version and update availability
  • Configuration file validity
  • Registered devices and their reachability
  • Network connectivity
  • Cloud authentication status
  • Firmware update availability

Use –full for all checks including device connectivity tests.

1
shelly doctor [flags]

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
  # Run basic diagnostics
  shelly doctor

  # Check network connectivity
  shelly doctor --network

  # Test all registered devices
  shelly doctor --devices

  # Full diagnostic suite
  shelly doctor --full

Options

1
2
3
4
      --devices   Test device reachability
      --full      Run all diagnostic checks
  -h, --help      help for doctor
      --network   Check network connectivity

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

  • shelly - CLI for controlling Shelly smart home devices