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

  # Interactive setup wizard (recommended for first use)
  shelly init

  # Quick setup with sensible defaults (no prompts)
  shelly init --defaults

  # Defaults with a specific theme
  shelly init --defaults --theme nord

  # Defaults with force overwrite of existing config
  shelly init --defaults --force

  # Check current setup without changes
  shelly init --check

  # Register devices directly (other steps remain interactive)
  shelly init --device kitchen=192.168.1.100 --device bedroom=192.168.1.101

  # Run discovery without prompting (other steps remain interactive)
  shelly init --discover

  # Scan specific subnets
  shelly init --discover --network 192.168.1.0/24 --network 10.0.0.0/24

  # Full CI/CD setup (no prompts)
  shelly init --defaults \
    --device kitchen=192.168.1.100 \
    --theme dracula \
    --no-color

  # With cloud credentials
  shelly init --defaults --cloud-email user@example.com --cloud-password secret

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

      --aliases                     Install default command aliases (opt-in)
      --all-networks                Scan all detected subnets without prompting
      --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)
      --defaults                    Use sensible defaults for all prompts (no interactive questions)
      --device stringArray          Device spec: name=ip[:user:pass] (repeatable)
      --devices-json stringArray    JSON device(s): file path, array, or single object (repeatable)
      --discover                    Run device discovery without prompting
      --discover-modes string       Discovery modes: http,mdns,coiot,ble,all (comma-separated) (default "http")
      --discover-timeout duration   Discovery timeout (default 2m0s)
      --force                       Overwrite existing configuration
  -h, --help                        help for init
      --network stringArray         Subnet(s) for HTTP probe discovery (repeatable)
      --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
12
13

      --config string           Config file (default $HOME/.config/shelly/config.yaml)
  -F, --fields                  Print available field names for use with --jq and --template
  -Q, --jq stringArray          Apply jq expression to filter output (repeatable, joined with |)
      --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)