1

shelly backup restore <device> <file> [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
34

  # Full restore from backup
  shelly backup restore living-room backup.json

  # Dry run - show what would change
  shelly backup restore living-room backup.json --dry-run

  # Restore without network config (keep current WiFi)
  shelly backup restore living-room backup.json --skip-network

  # Restore without auth config
  shelly backup restore living-room backup.json --skip-auth

  # Restore encrypted backup
  shelly backup restore living-room backup.json --decrypt mysecret

  # Skip scripts during restore
  shelly backup restore living-room backup.json --skip-scripts

  # Clone another bulb's backup onto this device with a different static IP
  # (identity — MAC, serial, device ID — is never overwritten by restore)
  shelly backup restore new-bulb master-bath-1.json \
    --static-ip 10.23.47.221 --gateway 10.23.47.1 --netmask 255.255.254.0 --dns 10.23.47.1

  # Restore a sibling's backup straight onto a brand-new device at its factory
  # WiFi AP: hops the host onto the AP, applies the config + static IP, and the
  # device joins the LAN — no separate provisioning step (target name = "fr")
  shelly backup restore fr sr.json --to-ap ShellyBulbDuo-D0DCFF \
    --static-ip 10.23.47.227 --gateway 10.23.47.1 --netmask 255.255.254.0 --dns 10.23.47.1

  # If the target runs older firmware than the backup, it is updated automatically
  # before the restore so the configuration lands on matched firmware and cannot
  # reboot-loop — no flag needed. With --to-ap the update runs AT the factory AP
  # (where the device is stable): the image is fetched before the hop and re-served
  # on the AP subnet, then the full restore proceeds once the device joins the LAN.

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

      --allow-firmware-downgrade   Force the older-firmware config write instead of the automatic firmware update (Gen1; the device is updated to matched firmware by default when the backup is newer — this skips that and accepts the reboot-loop risk)
      --ap-ip string               Static host IP to use on the device's AP subnet during --to-ap (default 192.168.33.133)
  -d, --decrypt string             Password to decrypt backup
      --dns string                 Static IPv4 nameserver (optional, with --static-ip)
      --dry-run                    Show what would be restored without applying
      --firmware-url string        Firmware image for the automatic downgrade-recovery update (default: derived from the backup's device model)
      --gateway string             Static IPv4 default gateway (with --static-ip)
  -h, --help                       help for restore
      --name string                Override the device name (defaults to the target identifier when it is a friendly alias)
      --netmask string             Static IPv4 subnet mask (with --static-ip)
      --password string            WiFi passphrase for the target network (optional: derived from this host's stored credentials when omitted; set to override or when derivation fails)
      --skip-auth                  Skip authentication configuration
      --skip-meters                Skip restoring meter/energy-meter configuration (e.g. overpower limits)
      --skip-network               Skip network configuration (WiFi, Ethernet)
      --skip-schedules             Skip schedule restoration
      --skip-scripts               Skip script restoration
      --skip-state                 Skip restoring live component state (color temperature, brightness); apply configuration only
      --skip-webhooks              Skip webhook restoration
      --ssid string                Override the WiFi SSID the device joins (defaults to the backup's network)
      --static-ip string           Override the backup's WiFi with this static IPv4 address
      --to-ap string               Restore onto a device at its factory WiFi AP with this SSID (hops host WiFi; the network override moves it onto the LAN)

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

      --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-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
      --raw                     Print the exact device response(s) as a JSON array and suppress normal 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)