Skip to content

backup_config

Snapshot every persistent resource on the controller into one envelope.

Side effects: None (read-only).

Captures networks/VLANs, WLANs, firewall rules, port profiles, static DHCP reservations, and port forwards into one versioned JSON envelope. Transient state (clients, devices, observability) is excluded.

Secret handling: every WLAN’s x_passphrase is replaced with the sentinel <redacted-on-backup>. The envelope flag secrets_stripped: true warns restore_config to force restored WLANs to enabled=False.

Returns the JSON envelope {"schema": "1", "controller": str, "ts": iso8601, "secrets_stripped": bool, "resources": {...}}.

backup_config(controller="default")
ParameterTypeRequiredDefaultDescription
controllerstringno”default”Name of the UniFi controller to target. Defaults to "default".