1

shelly init [flags]

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

  # Interactive setup wizard
  shelly init

  # Check current setup without changes
  shelly init --check

  # Non-interactive: register devices directly
  shelly init --device kitchen=192.168.1.100 --device bedroom=192.168.1.101

  # Non-interactive: device with authentication
  shelly init --device secure=192.168.1.102:admin:secret

  # Non-interactive: import from JSON file
  shelly init --devices-json devices.json

  # Non-interactive: inline JSON
  shelly init --devices-json '{"name":"kitchen","address":"192.168.1.100"}'

  # Non-interactive: with discovery and completions
  shelly init --discover --discover-modes http,mdns --completions bash,zsh

  # Non-interactive: full CI/CD setup
  shelly init \
    --device kitchen=192.168.1.100 \
    --theme dracula \
    --api-mode local \
    --no-color

  # Non-interactive: with cloud credentials
  shelly init --cloud-email user@example.com --cloud-password secret

  # Non-interactive: enable anonymous telemetry
  shelly init --telemetry

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

      --aliases                     Install default command aliases (opt-in)
      --api-mode string             API mode: local,cloud,auto (default: local)
      --check                       Verify current setup without making changes
      --cloud-email string          Shelly Cloud email (enables cloud setup)
      --cloud-password string       Shelly Cloud password (enables cloud setup)
      --completions string          Install completions for shells: bash,zsh,fish,powershell (comma-separated)
      --device stringArray          Device spec: name=ip[:user:pass] (repeatable)
      --devices-json stringArray    JSON device(s): file path, array, or single object (repeatable)
      --discover                    Enable device discovery (opt-in in non-interactive mode)
      --discover-modes string       Discovery modes: http,mdns,coiot,ble,all (comma-separated) (default "http")
      --discover-timeout duration   Discovery timeout (default 15s)
      --force                       Overwrite existing configuration
  -h, --help                        help for init
      --network string              Subnet for HTTP probe discovery (e.g., 192.168.1.0/24)
      --no-color                    Disable colors in output
      --output-format string        Set output format: table,json,yaml (default: table)
      --telemetry                   Enable anonymous usage telemetry (opt-in)
      --theme string                Set theme (default: dracula)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

      --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-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)