balena-cli 23.2.12-build-update-docker-progress-5-4-0-811c0528e46a6e41ba3a6564928be114cd673ce7-1 → 23.2.12

package/oclif.manifest.json

@@ -1018,54 +1018,16 @@
         "list.js"
       ]
     },
-    "device:deactivate": {
-      "aliases": [],
-      "args": {
-        "uuid": {
-          "description": "the UUID of the device to be deactivated",
-          "name": "uuid",
-          "required": true
-        }
-      },
-      "description": "Deactivate a device.\n\nDeactivate a device.\n\nNote this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` option.",
-      "examples": [
-        "$ balena device deactivate 7cf02a6",
-        "$ balena device deactivate 7cf02a6 --yes"
-      ],
-      "flags": {
-        "yes": {
-          "char": "y",
-          "description": "answer \"yes\" to all questions (non interactive use)",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "device:deactivate",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "device",
-        "deactivate.js"
-      ]
-    },
-    "device:detect": {
+    "env:list": {
       "aliases": [],
       "args": {},
-      "description": "Scan for balenaOS devices on your local network.\n\nScan for balenaOS devices on your local network.\n\nThe output includes device information collected through balenaEngine for\ndevices running a development image of balenaOS. Devices running a production\nimage do not expose balenaEngine (on TCP port 2375), which is why less\ninformation is printed about them.",
+      "description": "List the environment or config variables of a fleet, device or service.\n\nList the environment or configuration variables of a fleet, device or\nservice, as selected by the respective command-line options. (A service\ncorresponds to a Docker image/container in a microservices fleet.)\n\nThe results include fleet-wide (multiple devices), device-specific (multiple\nservices on a specific device) and service-specific variables that apply to the\nselected fleet, device or service. It can be thought of as including inherited\nvariables; for example, a service inherits device-wide variables, and a device\ninherits fleet-wide variables.\n\nThe printed output may include DEVICE and/or SERVICE columns to distinguish\nbetween fleet-wide, device-specific and service-specific variables.\nAn asterisk in these columns indicates that the variable applies to\n\"all devices\" or \"all services\".\n\nThe --config option is used to list \"configuration variables\" that control\nbalena platform features, as opposed to custom environment variables defined\nby the user. The --config and the --service options are mutually exclusive\nbecause configuration variables cannot be set for specific services.\n\nWhen --json is used, an empty JSON array ([]) is printed instead of an error \nmessage when no variables exist for the given query. When querying variables \nfor a device, note that the fleet name may be null in JSON output \n(or 'N/A' in tabular output) if the fleet that the device belonged to is no \nlonger accessible by the current user (for example, in case the current user \nwas removed from the fleet by the fleet's owner).\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
       "examples": [
-        "$ balena device detect",
-        "$ balena device detect --timeout 120",
-        "$ balena device detect --verbose"
+        "$ balena env list --fleet myorg/myfleet",
+        "$ balena env list --fleet MyFleet --service MyService",
+        "$ balena env list --fleet MyFleet --config",
+        "$ balena env list --device 7cf02a6",
+        "$ balena env list --device 7cf02a6 --service MyService"
       ],
       "flags": {
         "json": {
@@ -1075,17 +1037,45 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "verbose": {
-          "char": "v",
-          "description": "display full info",
-          "name": "verbose",
+        "fleet": {
+          "char": "f",
+          "description": "fleet name or slug (preferred)",
+          "exclusive": [
+            "device"
+          ],
+          "name": "fleet",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "config": {
+          "char": "c",
+          "description": "show configuration variables only",
+          "exclusive": [
+            "service"
+          ],
+          "name": "config",
           "allowNo": false,
           "type": "boolean"
         },
-        "timeout": {
-          "char": "t",
-          "description": "scan timeout in seconds",
-          "name": "timeout",
+        "device": {
+          "char": "d",
+          "description": "device UUID",
+          "exclusive": [
+            "fleet"
+          ],
+          "name": "device",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "service": {
+          "char": "s",
+          "description": "service name",
+          "exclusive": [
+            "config"
+          ],
+          "name": "service",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1093,191 +1083,255 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:detect",
+      "id": "env:list",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
-      "primary": true,
-      "root": true,
-      "offlineCompatible": true,
-      "dockerInfoProperties": [
-        "Containers",
-        "ContainersRunning",
-        "ContainersPaused",
-        "ContainersStopped",
-        "Images",
-        "Driver",
-        "SystemTime",
-        "KernelVersion",
-        "OperatingSystem",
-        "Architecture"
-      ],
-      "dockerVersionProperties": [
-        "Version",
-        "ApiVersion"
-      ],
-      "noDevicesFoundMessage": "Could not find any balenaOS devices on the local network.",
-      "windowsTipMessage": "\n\nNote for Windows users:\n  The 'device detect' command relies on the Bonjour service. Check whether Bonjour is\n  installed (Control Panel > Programs and Features). If not, you can download\n  Bonjour for Windows (included with Bonjour Print Services) from here:\n  https://support.apple.com/kb/DL999\n\n  After installing Bonjour, restart your PC and run the 'balena device detect' command\n  again.",
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "device",
-        "detect.js"
+        "env",
+        "list.js"
       ]
     },
-    "device:identify": {
+    "env:rename": {
       "aliases": [],
       "args": {
-        "uuid": {
-          "description": "the uuid of the device to identify",
-          "name": "uuid",
+        "id": {
+          "description": "variable's numeric database ID",
+          "name": "id",
+          "required": true
+        },
+        "value": {
+          "description": "variable value; if omitted, use value from this process' environment",
+          "name": "value",
           "required": true
         }
       },
-      "description": "Identify a device.\n\nIdentify a device by making the ACT LED blink (Raspberry Pi).",
+      "description": "Change the value of a config or env var for a fleet, device or service.\n\nChange the value of a configuration or environment variable for a fleet,\ndevice or service, as selected by command-line options.\n\nVariables are selected by their database ID (as reported by the 'balena env list'\ncommand) and one of six database \"resource types\":\n\n- fleet environment variable\n- fleet configuration variable (--config)\n- fleet service variable (--service)\n- device environment variable (--device)\n- device configuration variable (--device --config)\n- device service variable (--device --service)\n\nThe --device option selects a device-specific variable instead of a fleet\nvariable.\n\nThe --config option selects a configuration variable. Configuration variable\nnames typically start with the 'BALENA_' or 'RESIN_' prefixes and are used to\nconfigure balena platform features.\n\nThe --service option selects a service variable, which is an environment variable\nthat applies to a specifc service (container) in a microservices (multicontainer)\nfleet.\n\nThe --service and --config options cannot be used together, but they can be\nused alongside the --device option to select a device-specific service or\nconfiguration variable.",
       "examples": [
-        "$ balena device identify 23c73a1"
+        "$ balena env rename 123123 emacs",
+        "$ balena env rename 234234 emacs --service",
+        "$ balena env rename 345345 emacs --device",
+        "$ balena env rename 456456 emacs --device --service",
+        "$ balena env rename 567567 1 --config",
+        "$ balena env rename 678678 1 --device --config"
       ],
-      "flags": {},
+      "flags": {
+        "config": {
+          "char": "c",
+          "description": "select a configuration variable (may be used together with the --device option)",
+          "exclusive": [
+            "service"
+          ],
+          "name": "config",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "device": {
+          "char": "d",
+          "description": "select a device-specific variable instead of a fleet variable",
+          "name": "device",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "service": {
+          "char": "s",
+          "description": "select a service variable (may be used together with the --device option)",
+          "exclusive": [
+            "config"
+          ],
+          "name": "service",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:identify",
+      "id": "env:rename",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "authenticated": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "device",
-        "identify.js"
+        "env",
+        "rename.js"
       ]
     },
-    "device": {
+    "env:rm": {
       "aliases": [],
       "args": {
-        "uuid": {
-          "description": "the device uuid",
-          "name": "uuid",
+        "id": {
+          "description": "variable's numeric database ID",
+          "name": "id",
           "required": true
         }
       },
-      "description": "Show info about a single device.\n\nShow information about a single device.",
+      "description": "Remove a config or env var from a fleet, device or service.\n\nRemove a configuration or environment variable from a fleet, device\nor service, as selected by command-line options.\n\nVariables are selected by their database ID (as reported by the 'balena env list'\ncommand) and one of six database \"resource types\":\n\n- fleet environment variable\n- fleet configuration variable (--config)\n- fleet service variable (--service)\n- device environment variable (--device)\n- device configuration variable (--device --config)\n- device service variable (--device --service)\n\nThe --device option selects a device-specific variable instead of a fleet\nvariable.\n\nThe --config option selects a configuration variable. Configuration variable\nnames typically start with the 'BALENA_' or 'RESIN_' prefixes and are used to\nconfigure balena platform features.\n\nThe --service option selects a service variable, which is an environment variable\nthat applies to a specifc service (container) in a microservices (multicontainer)\nfleet.\n\nThe --service and --config options cannot be used together, but they can be\nused alongside the --device option to select a device-specific service or\nconfiguration variable.\n\nInteractive confirmation is normally asked before the variable is deleted.\nThe --yes option disables this behavior.",
       "examples": [
-        "$ balena device 7cf02a6",
-        "$ balena device 7cf02a6 --view"
+        "$ balena env rm 123123",
+        "$ balena env rm 234234 --yes",
+        "$ balena env rm 345345 --config",
+        "$ balena env rm 456456 --service",
+        "$ balena env rm 567567 --device",
+        "$ balena env rm 678678 --device --config",
+        "$ balena env rm 789789 --device --service --yes"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+        "config": {
+          "char": "c",
+          "description": "select a configuration variable (may be used together with the --device option)",
+          "exclusive": [
+            "service"
+          ],
+          "name": "config",
           "allowNo": false,
           "type": "boolean"
         },
-        "view": {
-          "description": "open device dashboard page",
-          "name": "view",
+        "device": {
+          "char": "d",
+          "description": "select a device-specific variable instead of a fleet variable",
+          "name": "device",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "service": {
+          "char": "s",
+          "description": "select a service variable (may be used together with the --device option)",
+          "exclusive": [
+            "config"
+          ],
+          "name": "service",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "do not prompt for confirmation before deleting the variable",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device",
+      "id": "env:rm",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": true,
-      "authenticated": true,
-      "primary": true,
+      "enableJsonFlag": false,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "device",
-        "index.js"
+        "env",
+        "rm.js"
       ]
     },
-    "device:init": {
+    "env:set": {
       "aliases": [],
-      "args": {},
-      "description": "Initialize a device with balenaOS.\n\nRegister a new device in the selected fleet, download the OS image for the\nfleet's default device type, configure the image and write it to an SD card.\nThis command effectively combines several other balena CLI commands in one,\nnamely:\n\n'balena device register'\n'balena os download'\n'balena config generate'\n'balena os configure'\n'balena os local flash'\n\nPossible arguments for the '--fleet', '--os-version' and '--drive' options can\nbe listed respectively with the commands:\n\n'balena fleet list'\n'balena os versions'\n'balena util available-drives'\n\nIf the '--fleet' or '--drive' options are omitted, interactive menus will be\npresented with values to choose from. If the '--os-version' option is omitted,\nthe latest released OS version for the fleet's default device type will be used.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).\n\nImage configuration questions will be asked interactively unless a pre-configured\n'config.json' file is provided with the '--config' option.  The file can be\ngenerated with the 'balena config generate' command.",
-      "examples": [
-        "$ balena device init",
-        "$ balena device init -f myorg/myfleet",
-        "$ balena device init --fleet myFleet --os-version 2.101.7 --drive /dev/disk5",
-        "$ balena device init --fleet myFleet --os-version 2.83.21+rev1.prod --drive /dev/disk5",
-        "$ balena device init --config config.json --os-version 2.101.7 --drive /dev/disk5 --yes"
+      "args": {
+        "name": {
+          "description": "environment or config variable name",
+          "name": "name",
+          "required": true
+        },
+        "value": {
+          "description": "variable value; if omitted, use value from this process' environment",
+          "name": "value",
+          "required": false
+        }
+      },
+      "description": "Add or update env or config variable to fleets, devices or services.\n\nAdd or update an environment or config variable to one or more fleets, devices or\nservices, as selected by the respective command-line options. Either the\n--fleet or the --device option must be provided,  and either may be be\nused alongside the --service option to define a service-specific variable.\n(A service corresponds to a Docker image/container in a microservices fleet.)\nWhen the --service option is used in conjunction with the --device option,\nthe service variable applies to the selected device only.  Otherwise, it\napplies to all devices of the selected fleet. If the --service option is\nomitted, the variable applies to all services.\n\nIf VALUE is omitted, the CLI will attempt to use the value of the environment\nvariable of same name in the CLI process' environment. In this case, a warning\nmessage will be printed. Use `--quiet` to suppress it.\n\n'BALENA_' or 'RESIN_' are reserved variable name prefixes used to identify\n\"configuration variables\". Configuration variables control balena platform\nfeatures and are treated specially by balenaOS and the balena supervisor\nrunning on devices. They are also stored differently in the balenaCloud API\ndatabase. Configuration variables cannot be set for specific services,\ntherefore the --service option cannot be used when the variable name starts\nwith a reserved prefix. When defining custom fleet variables, please avoid\nthese reserved prefixes.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
+      "examples": [
+        "$ balena env set TERM --fleet MyFleet",
+        "$ balena env set EDITOR vim -f myorg/myfleet",
+        "$ balena env set EDITOR vim --fleet MyFleet,MyFleet2",
+        "$ balena env set EDITOR vim --fleet MyFleet --service MyService",
+        "$ balena env set EDITOR vim --fleet MyFleet,MyFleet2 --service MyService,MyService2",
+        "$ balena env set EDITOR vim --device 7cf02a6",
+        "$ balena env set EDITOR vim --device 7cf02a6,d6f1433",
+        "$ balena env set EDITOR vim --device 7cf02a6 --service MyService",
+        "$ balena env set EDITOR vim --device 7cf02a6,d6f1433 --service MyService,MyService2"
       ],
       "flags": {
         "fleet": {
           "char": "f",
           "description": "fleet name or slug (preferred)",
           "exclusive": [
-            "config"
+            "device"
           ],
           "name": "fleet",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "config": {
-          "description": "path to the config JSON file, see `balena config generate`",
+        "device": {
+          "char": "d",
+          "description": "device UUID",
           "exclusive": [
-            "fleet",
-            "advanced",
-            "provisioning-key-name",
-            "provisioning-key-expiry-date"
+            "fleet"
           ],
-          "name": "config",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "os-version": {
-          "description": "exact version number, or a valid semver range,\nor 'latest' (includes pre-releases),\nor 'default' (excludes pre-releases if at least one stable version is available),\nor 'recommended' (excludes pre-releases, will fail if only pre-release versions are available),\nor 'menu' (will show the interactive menu)",
-          "name": "os-version",
+          "name": "device",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "advanced": {
-          "char": "v",
-          "description": "show advanced configuration options",
-          "name": "advanced",
+        "quiet": {
+          "char": "q",
+          "description": "suppress warning messages",
+          "name": "quiet",
           "allowNo": false,
           "type": "boolean"
         },
-        "provisioning-key-name": {
-          "description": "custom key name assigned to generated provisioning api key",
-          "name": "provisioning-key-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "provisioning-key-expiry-date": {
-          "description": "expiry date assigned to generated provisioning api key (format: YYYY-MM-DD)",
-          "name": "provisioning-key-expiry-date",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "drive": {
-          "char": "d",
-          "description": "the drive to write the image to, eg. `/dev/sdb` or `/dev/mmcblk0`.\nCareful with this as you can erase your hard drive.\nCheck `balena util available-drives` for available options.",
-          "name": "drive",
+        "service": {
+          "char": "s",
+          "description": "service name",
+          "name": "service",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "env:set",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "env",
+        "set.js"
+      ]
+    },
+    "device:deactivate": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "the UUID of the device to be deactivated",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Deactivate a device.\n\nDeactivate a device.\n\nNote this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` option.",
+      "examples": [
+        "$ balena device deactivate 7cf02a6",
+        "$ balena device deactivate 7cf02a6 --yes"
+      ],
+      "flags": {
         "yes": {
           "char": "y",
           "description": "answer \"yes\" to all questions (non interactive use)",
@@ -1288,7 +1342,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:init",
+      "id": "device:deactivate",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1300,17 +1354,17 @@
         "build",
         "commands",
         "device",
-        "init.js"
+        "deactivate.js"
       ]
     },
-    "device:list": {
+    "device:detect": {
       "aliases": [],
       "args": {},
-      "description": "List all devices.\n\nList all of your devices.\n\nDevices can be filtered by fleet with the `--fleet` option.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
+      "description": "Scan for balenaOS devices on your local network.\n\nScan for balenaOS devices on your local network.\n\nThe output includes device information collected through balenaEngine for\ndevices running a development image of balenaOS. Devices running a production\nimage do not expose balenaEngine (on TCP port 2375), which is why less\ninformation is printed about them.",
       "examples": [
-        "$ balena device list",
-        "$ balena device list --fleet MyFleet",
-        "$ balena device list -f myorg/myfleet"
+        "$ balena device detect",
+        "$ balena device detect --timeout 120",
+        "$ balena device detect --verbose"
       ],
       "flags": {
         "json": {
@@ -1320,10 +1374,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "fleet": {
-          "char": "f",
-          "description": "fleet name or slug (preferred)",
-          "name": "fleet",
+        "verbose": {
+          "char": "v",
+          "description": "display full info",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "char": "t",
+          "description": "scan timeout in seconds",
+          "name": "timeout",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1331,73 +1392,58 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:list",
+      "id": "device:detect",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": true,
       "primary": true,
-      "authenticated": true,
+      "root": true,
+      "offlineCompatible": true,
+      "dockerInfoProperties": [
+        "Containers",
+        "ContainersRunning",
+        "ContainersPaused",
+        "ContainersStopped",
+        "Images",
+        "Driver",
+        "SystemTime",
+        "KernelVersion",
+        "OperatingSystem",
+        "Architecture"
+      ],
+      "dockerVersionProperties": [
+        "Version",
+        "ApiVersion"
+      ],
+      "noDevicesFoundMessage": "Could not find any balenaOS devices on the local network.",
+      "windowsTipMessage": "\n\nNote for Windows users:\n  The 'device detect' command relies on the Bonjour service. Check whether Bonjour is\n  installed (Control Panel > Programs and Features). If not, you can download\n  Bonjour for Windows (included with Bonjour Print Services) from here:\n  https://support.apple.com/kb/DL999\n\n  After installing Bonjour, restart your PC and run the 'balena device detect' command\n  again.",
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
         "device",
-        "list.js"
+        "detect.js"
       ]
     },
-    "device:local-mode": {
+    "device:identify": {
       "aliases": [],
       "args": {
         "uuid": {
-          "description": "the uuid of the device to manage",
+          "description": "the uuid of the device to identify",
           "name": "uuid",
           "required": true
         }
       },
-      "description": "Get or manage the local mode status for a device.\n\nOutput current local mode status, or enable/disable local mode\nfor specified device.",
+      "description": "Identify a device.\n\nIdentify a device by making the ACT LED blink (Raspberry Pi).",
       "examples": [
-        "$ balena device local-mode 23c73a1",
-        "$ balena device local-mode 23c73a1 --enable",
-        "$ balena device local-mode 23c73a1 --disable",
-        "$ balena device local-mode 23c73a1 --status"
+        "$ balena device identify 23c73a1"
       ],
-      "flags": {
-        "enable": {
-          "description": "enable local mode",
-          "exclusive": [
-            "disable",
-            "status"
-          ],
-          "name": "enable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "disable": {
-          "description": "disable local mode",
-          "exclusive": [
-            "enable",
-            "status"
-          ],
-          "name": "disable",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "status": {
-          "description": "output boolean indicating local mode status",
-          "exclusive": [
-            "enable",
-            "disable"
-          ],
-          "name": "status",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:local-mode",
+      "id": "device:identify",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1409,197 +1455,128 @@
         "build",
         "commands",
         "device",
-        "local-mode.js"
+        "identify.js"
       ]
     },
-    "device:logs": {
+    "device": {
       "aliases": [],
       "args": {
-        "device": {
-          "description": "device UUID, IP, or .local address",
-          "name": "device",
+        "uuid": {
+          "description": "the device uuid",
+          "name": "uuid",
           "required": true
         }
       },
-      "description": "Show device logs.\n\nShow logs for a specific device.\n\nBy default, the command prints all log messages and exits.\n\nTo continuously stream output, and see new logs in real time, use the `--tail` option.\n\nIf an IP or .local address is passed to this command, logs are displayed from\na local mode device with that address. Note that --tail is implied\nwhen this command is provided a local mode device.\n\nLogs from a single service can be displayed with the --service flag. Just system logs\ncan be shown with the --system flag. Note that these flags can be used together.\n\nNote: --service and --system flags must come after the device parameter, as per examples.",
+      "description": "Show info about a single device.\n\nShow information about a single device.",
       "examples": [
-        "$ balena device logs 23c73a1",
-        "$ balena device logs 23c73a1 --tail",
-        "",
-        "$ balena device logs 192.168.0.31",
-        "$ balena device logs 192.168.0.31 --service my-service",
-        "$ balena device logs 192.168.0.31 --service my-service-1 --service my-service-2",
-        "",
-        "$ balena device logs 23c73a1.local --system",
-        "$ balena device logs 23c73a1.local --system --service my-service"
+        "$ balena device 7cf02a6",
+        "$ balena device 7cf02a6 --view"
       ],
       "flags": {
-        "max-retry": {
-          "description": "Maximum number of reconnection attempts on \"connection lost\" errors\n(use 0 to disable auto reconnection).",
-          "name": "max-retry",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tail": {
-          "char": "t",
-          "description": "continuously stream output",
-          "name": "tail",
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
           "allowNo": false,
           "type": "boolean"
         },
-        "service": {
-          "char": "s",
-          "description": "Reject logs not originating from this service.\nThis can be used in combination with --system or other --service flags.",
-          "name": "service",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "system": {
-          "char": "S",
-          "description": "Only show system logs. This can be used in combination with --service.",
-          "name": "system",
+        "view": {
+          "description": "open device dashboard page",
+          "name": "view",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:logs",
+      "id": "device",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
+      "authenticated": true,
       "primary": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
         "device",
-        "logs.js"
+        "index.js"
       ]
     },
-    "device:move": {
+    "device:init": {
       "aliases": [],
-      "args": {
-        "uuid": {
-          "description": "comma-separated list (no blank spaces) of device UUIDs to be moved",
-          "name": "uuid",
-          "required": true
-        }
-      },
-      "description": "Move one or more devices to another fleet.\n\nMove one or more devices to another fleet.\n\nIf --fleet is omitted, the fleet will be prompted for interactively.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
+      "args": {},
+      "description": "Initialize a device with balenaOS.\n\nRegister a new device in the selected fleet, download the OS image for the\nfleet's default device type, configure the image and write it to an SD card.\nThis command effectively combines several other balena CLI commands in one,\nnamely:\n\n'balena device register'\n'balena os download'\n'balena config generate'\n'balena os configure'\n'balena os local flash'\n\nPossible arguments for the '--fleet', '--os-version' and '--drive' options can\nbe listed respectively with the commands:\n\n'balena fleet list'\n'balena os versions'\n'balena util available-drives'\n\nIf the '--fleet' or '--drive' options are omitted, interactive menus will be\npresented with values to choose from. If the '--os-version' option is omitted,\nthe latest released OS version for the fleet's default device type will be used.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).\n\nImage configuration questions will be asked interactively unless a pre-configured\n'config.json' file is provided with the '--config' option.  The file can be\ngenerated with the 'balena config generate' command.",
       "examples": [
-        "$ balena device move 7cf02a6",
-        "$ balena device move 7cf02a6,dc39e52",
-        "$ balena device move 7cf02a6 --fleet MyNewFleet",
-        "$ balena device move 7cf02a6 -f myorg/mynewfleet"
+        "$ balena device init",
+        "$ balena device init -f myorg/myfleet",
+        "$ balena device init --fleet myFleet --os-version 2.101.7 --drive /dev/disk5",
+        "$ balena device init --fleet myFleet --os-version 2.83.21+rev1.prod --drive /dev/disk5",
+        "$ balena device init --config config.json --os-version 2.101.7 --drive /dev/disk5 --yes"
       ],
       "flags": {
         "fleet": {
           "char": "f",
           "description": "fleet name or slug (preferred)",
+          "exclusive": [
+            "config"
+          ],
           "name": "fleet",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "device:move",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "device",
-        "move.js"
-      ]
-    },
-    "device:note": {
-      "aliases": [],
-      "args": {
-        "note": {
-          "description": "note content",
-          "name": "note"
-        }
-      },
-      "description": "Set a device note.\n\nSet or update a device note. If the note argument is not provided,\nit will be read from stdin.\n\nTo view device notes, use the `balena device <uuid>` command.",
-      "examples": [
-        "$ balena device note \"My useful note\" --device 7cf02a6",
-        "$ cat note.txt | balena device note --device 7cf02a6"
-      ],
-      "flags": {
-        "device": {
-          "char": "d",
-          "description": "device UUID",
-          "name": "device",
+        },
+        "config": {
+          "description": "path to the config JSON file, see `balena config generate`",
+          "exclusive": [
+            "fleet",
+            "advanced",
+            "provisioning-key-name",
+            "provisioning-key-expiry-date"
+          ],
+          "name": "config",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "device:note",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "device",
-        "note.js"
-      ]
-    },
-    "device:os-update": {
-      "aliases": [],
-      "args": {
-        "uuid": {
-          "description": "the uuid of the device to update",
-          "name": "uuid",
-          "required": true
-        }
-      },
-      "description": "Start a Host OS update for a device.\n\nStart a Host OS update for a device.\n\nNote this command will ask for confirmation interactively.\nThis can be avoided by passing the `--yes` option.\n\nRequires balenaCloud; will not work with openBalena or standalone balenaOS.",
-      "examples": [
-        "$ balena device os-update 23c73a1",
-        "$ balena device os-update 23c73a1 --version 2.101.7",
-        "$ balena device os-update 23c73a1 --version 2.31.0+rev1.prod",
-        "$ balena device os-update 23c73a1 --include-draft"
-      ],
-      "flags": {
-        "version": {
-          "description": "a balenaOS version",
-          "exclusive": [
-            "include-draft"
-          ],
-          "name": "version",
+        },
+        "os-version": {
+          "description": "exact version number, or a valid semver range,\nor 'latest' (includes pre-releases),\nor 'default' (excludes pre-releases if at least one stable version is available),\nor 'recommended' (excludes pre-releases, will fail if only pre-release versions are available),\nor 'menu' (will show the interactive menu)",
+          "name": "os-version",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "include-draft": {
-          "description": "include pre-release balenaOS versions",
-          "exclusive": [
-            "version"
-          ],
-          "name": "include-draft",
+        "advanced": {
+          "char": "v",
+          "description": "show advanced configuration options",
+          "name": "advanced",
           "allowNo": false,
           "type": "boolean"
         },
+        "provisioning-key-name": {
+          "description": "custom key name assigned to generated provisioning api key",
+          "name": "provisioning-key-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "provisioning-key-expiry-date": {
+          "description": "expiry date assigned to generated provisioning api key (format: YYYY-MM-DD)",
+          "name": "provisioning-key-expiry-date",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "drive": {
+          "char": "d",
+          "description": "the drive to write the image to, eg. `/dev/sdb` or `/dev/mmcblk0`.\nCareful with this as you can erase your hard drive.\nCheck `balena util available-drives` for available options.",
+          "name": "drive",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "yes": {
           "char": "y",
           "description": "answer \"yes\" to all questions (non interactive use)",
@@ -1610,7 +1587,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:os-update",
+      "id": "device:init",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1622,46 +1599,54 @@
         "build",
         "commands",
         "device",
-        "os-update.js"
+        "init.js"
       ]
     },
-    "device:pin": {
+    "device:list": {
       "aliases": [],
-      "args": {
-        "uuid": {
-          "description": "the uuid of the device to pin to a release",
-          "name": "uuid",
-          "required": true
+      "args": {},
+      "description": "List all devices.\n\nList all of your devices.\n\nDevices can be filtered by fleet with the `--fleet` option.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
+      "examples": [
+        "$ balena device list",
+        "$ balena device list --fleet MyFleet",
+        "$ balena device list -f myorg/myfleet"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "releaseToPinTo": {
-          "description": "the commit of the release for the device to get pinned to",
-          "name": "releaseToPinTo"
+        "fleet": {
+          "char": "f",
+          "description": "fleet name or slug (preferred)",
+          "name": "fleet",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
-      "description": "Pin a device to a release.\n\nPin a device to a release.\n\nNote, if the commit is omitted, the currently pinned release will be printed, with instructions for how to see a list of releases",
-      "examples": [
-        "$ balena device pin 7cf02a6",
-        "$ balena device pin 7cf02a6 91165e5"
-      ],
-      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:pin",
+      "id": "device:list",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
-      "enableJsonFlag": false,
+      "enableJsonFlag": true,
+      "primary": true,
       "authenticated": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
         "device",
-        "pin.js"
+        "list.js"
       ]
     },
-    "device:public-url": {
+    "device:local-mode": {
       "aliases": [],
       "args": {
         "uuid": {
@@ -1670,16 +1655,16 @@
           "required": true
         }
       },
-      "description": "Get or manage the public URL for a device.\n\nThis command will output the current public URL for the\nspecified device.  It can also enable or disable the URL,\nor output the enabled status, using the respective options.",
+      "description": "Get or manage the local mode status for a device.\n\nOutput current local mode status, or enable/disable local mode\nfor specified device.",
       "examples": [
-        "$ balena device public-url 23c73a1",
-        "$ balena device public-url 23c73a1 --enable",
-        "$ balena device public-url 23c73a1 --disable",
-        "$ balena device public-url 23c73a1 --status"
+        "$ balena device local-mode 23c73a1",
+        "$ balena device local-mode 23c73a1 --enable",
+        "$ balena device local-mode 23c73a1 --disable",
+        "$ balena device local-mode 23c73a1 --status"
       ],
       "flags": {
         "enable": {
-          "description": "enable the public URL",
+          "description": "enable local mode",
           "exclusive": [
             "disable",
             "status"
@@ -1689,7 +1674,7 @@
           "type": "boolean"
         },
         "disable": {
-          "description": "disable the public URL",
+          "description": "disable local mode",
           "exclusive": [
             "enable",
             "status"
@@ -1699,7 +1684,7 @@
           "type": "boolean"
         },
         "status": {
-          "description": "determine if public URL is enabled",
+          "description": "output boolean indicating local mode status",
           "exclusive": [
             "enable",
             "disable"
@@ -1711,7 +1696,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:public-url",
+      "id": "device:local-mode",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1723,66 +1708,107 @@
         "build",
         "commands",
         "device",
-        "public-url.js"
+        "local-mode.js"
       ]
     },
-    "device:purge": {
+    "device:logs": {
       "aliases": [],
       "args": {
-        "uuid": {
-          "description": "comma-separated list (no blank spaces) of device UUIDs",
-          "name": "uuid",
+        "device": {
+          "description": "device UUID, IP, or .local address",
+          "name": "device",
           "required": true
         }
       },
-      "description": "Purge data from a device.\n\nPurge data from a device.\nThis will clear the device's \"/data\" directory.\n\nMultiple devices may be specified with a comma-separated list\nof values (no spaces).",
+      "description": "Show device logs.\n\nShow logs for a specific device.\n\nBy default, the command prints all log messages and exits.\n\nTo continuously stream output, and see new logs in real time, use the `--tail` option.\n\nIf an IP or .local address is passed to this command, logs are displayed from\na local mode device with that address. Note that --tail is implied\nwhen this command is provided a local mode device.\n\nLogs from a single service can be displayed with the --service flag. Just system logs\ncan be shown with the --system flag. Note that these flags can be used together.\n\nNote: --service and --system flags must come after the device parameter, as per examples.",
       "examples": [
-        "$ balena device purge 23c73a1",
-        "$ balena device purge 55d43b3,23c73a1"
+        "$ balena device logs 23c73a1",
+        "$ balena device logs 23c73a1 --tail",
+        "",
+        "$ balena device logs 192.168.0.31",
+        "$ balena device logs 192.168.0.31 --service my-service",
+        "$ balena device logs 192.168.0.31 --service my-service-1 --service my-service-2",
+        "",
+        "$ balena device logs 23c73a1.local --system",
+        "$ balena device logs 23c73a1.local --system --service my-service"
       ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "device:purge",
+      "flags": {
+        "max-retry": {
+          "description": "Maximum number of reconnection attempts on \"connection lost\" errors\n(use 0 to disable auto reconnection).",
+          "name": "max-retry",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "tail": {
+          "char": "t",
+          "description": "continuously stream output",
+          "name": "tail",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "service": {
+          "char": "s",
+          "description": "Reject logs not originating from this service.\nThis can be used in combination with --system or other --service flags.",
+          "name": "service",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "system": {
+          "char": "S",
+          "description": "Only show system logs. This can be used in combination with --service.",
+          "name": "system",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:logs",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "authenticated": true,
+      "primary": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
         "device",
-        "purge.js"
+        "logs.js"
       ]
     },
-    "device:reboot": {
+    "device:move": {
       "aliases": [],
       "args": {
         "uuid": {
-          "description": "the uuid of the device to reboot",
+          "description": "comma-separated list (no blank spaces) of device UUIDs to be moved",
           "name": "uuid",
           "required": true
         }
       },
-      "description": "Restart a device.\n\nRemotely reboot a device.",
+      "description": "Move one or more devices to another fleet.\n\nMove one or more devices to another fleet.\n\nIf --fleet is omitted, the fleet will be prompted for interactively.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
       "examples": [
-        "$ balena device reboot 23c73a1"
+        "$ balena device move 7cf02a6",
+        "$ balena device move 7cf02a6,dc39e52",
+        "$ balena device move 7cf02a6 --fleet MyNewFleet",
+        "$ balena device move 7cf02a6 -f myorg/mynewfleet"
       ],
       "flags": {
-        "force": {
+        "fleet": {
           "char": "f",
-          "description": "force action if the update lock is set",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+          "description": "fleet name or slug (preferred)",
+          "name": "fleet",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:reboot",
+      "id": "device:move",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1794,37 +1820,27 @@
         "build",
         "commands",
         "device",
-        "reboot.js"
+        "move.js"
       ]
     },
-    "device:register": {
+    "device:note": {
       "aliases": [],
       "args": {
-        "fleet": {
-          "description": "fleet name or slug (preferred)",
-          "name": "fleet",
-          "required": true
+        "note": {
+          "description": "note content",
+          "name": "note"
         }
       },
-      "description": "Register a new device.\n\nRegister a new device with a balena fleet.\n\nIf --uuid is not provided, a new UUID will be automatically assigned.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
+      "description": "Set a device note.\n\nSet or update a device note. If the note argument is not provided,\nit will be read from stdin.\n\nTo view device notes, use the `balena device <uuid>` command.",
       "examples": [
-        "$ balena device register MyFleet",
-        "$ balena device register MyFleet --uuid <uuid>",
-        "$ balena device register myorg/myfleet --uuid <uuid>",
-        "$ balena device register myorg/myfleet --uuid <uuid> --deviceType <deviceTypeSlug>"
+        "$ balena device note \"My useful note\" --device 7cf02a6",
+        "$ cat note.txt | balena device note --device 7cf02a6"
       ],
       "flags": {
-        "uuid": {
-          "char": "u",
-          "description": "custom uuid",
-          "name": "uuid",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "deviceType": {
-          "description": "device type slug (run 'balena device-type list' for possible values)",
-          "name": "deviceType",
+        "device": {
+          "char": "d",
+          "description": "device UUID",
+          "name": "device",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1832,7 +1848,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:register",
+      "id": "device:note",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1844,31 +1860,56 @@
         "build",
         "commands",
         "device",
-        "register.js"
+        "note.js"
       ]
     },
-    "device:rename": {
+    "device:os-update": {
       "aliases": [],
       "args": {
         "uuid": {
-          "description": "the uuid of the device to rename",
+          "description": "the uuid of the device to update",
           "name": "uuid",
           "required": true
-        },
-        "newName": {
-          "description": "the new name for the device",
-          "name": "newName"
         }
       },
-      "description": "Rename a device.\n\nRename a device.\n\nNote, if the name is omitted, it will be prompted for interactively.",
+      "description": "Start a Host OS update for a device.\n\nStart a Host OS update for a device.\n\nNote this command will ask for confirmation interactively.\nThis can be avoided by passing the `--yes` option.\n\nRequires balenaCloud; will not work with openBalena or standalone balenaOS.",
       "examples": [
-        "$ balena device rename 7cf02a6",
-        "$ balena device rename 7cf02a6 MyPi"
+        "$ balena device os-update 23c73a1",
+        "$ balena device os-update 23c73a1 --version 2.101.7",
+        "$ balena device os-update 23c73a1 --version 2.31.0+rev1.prod",
+        "$ balena device os-update 23c73a1 --include-draft"
       ],
-      "flags": {},
+      "flags": {
+        "version": {
+          "description": "a balenaOS version",
+          "exclusive": [
+            "include-draft"
+          ],
+          "name": "version",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "include-draft": {
+          "description": "include pre-release balenaOS versions",
+          "exclusive": [
+            "version"
+          ],
+          "name": "include-draft",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "answer \"yes\" to all questions (non interactive use)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:rename",
+      "id": "device:os-update",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1880,38 +1921,31 @@
         "build",
         "commands",
         "device",
-        "rename.js"
+        "os-update.js"
       ]
     },
-    "device:restart": {
+    "device:pin": {
       "aliases": [],
       "args": {
         "uuid": {
-          "description": "comma-separated list (no blank spaces) of device UUIDs to restart",
+          "description": "the uuid of the device to pin to a release",
           "name": "uuid",
           "required": true
+        },
+        "releaseToPinTo": {
+          "description": "the commit of the release for the device to get pinned to",
+          "name": "releaseToPinTo"
         }
       },
-      "description": "Restart containers on a device.\n\nRestart containers on a device.\nIf the --service flag is provided, then only those services' containers\nwill be restarted, otherwise all containers on the device will be restarted.\n\nMultiple devices and services may be specified with a comma-separated list\nof values (no spaces).\n\nNote this does not reboot the device, to do so use instead `balena device reboot`.",
+      "description": "Pin a device to a release.\n\nPin a device to a release.\n\nNote, if the commit is omitted, the currently pinned release will be printed, with instructions for how to see a list of releases",
       "examples": [
-        "$ balena device restart 23c73a1",
-        "$ balena device restart 55d43b3,23c73a1",
-        "$ balena device restart 23c73a1 --service myService",
-        "$ balena device restart 23c73a1 -s myService1,myService2"
+        "$ balena device pin 7cf02a6",
+        "$ balena device pin 7cf02a6 91165e5"
       ],
-      "flags": {
-        "service": {
-          "char": "s",
-          "description": "comma-separated list (no blank spaces) of service names to restart",
-          "name": "service",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:restart",
+      "id": "device:pin",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1923,36 +1957,60 @@
         "build",
         "commands",
         "device",
-        "restart.js"
+        "pin.js"
       ]
     },
-    "device:rm": {
+    "device:public-url": {
       "aliases": [],
       "args": {
         "uuid": {
-          "description": "comma-separated list (no blank spaces) of device UUIDs to be removed",
+          "description": "the uuid of the device to manage",
           "name": "uuid",
           "required": true
         }
       },
-      "description": "Remove one or more devices.\n\nRemove one or more devices from balena.\n\nNote this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` option.",
+      "description": "Get or manage the public URL for a device.\n\nThis command will output the current public URL for the\nspecified device.  It can also enable or disable the URL,\nor output the enabled status, using the respective options.",
       "examples": [
-        "$ balena device rm 7cf02a6",
-        "$ balena device rm 7cf02a6,dc39e52",
-        "$ balena device rm 7cf02a6 --yes"
+        "$ balena device public-url 23c73a1",
+        "$ balena device public-url 23c73a1 --enable",
+        "$ balena device public-url 23c73a1 --disable",
+        "$ balena device public-url 23c73a1 --status"
       ],
       "flags": {
-        "yes": {
-          "char": "y",
-          "description": "answer \"yes\" to all questions (non interactive use)",
-          "name": "yes",
+        "enable": {
+          "description": "enable the public URL",
+          "exclusive": [
+            "disable",
+            "status"
+          ],
+          "name": "enable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "disable": {
+          "description": "disable the public URL",
+          "exclusive": [
+            "enable",
+            "status"
+          ],
+          "name": "disable",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "status": {
+          "description": "determine if public URL is enabled",
+          "exclusive": [
+            "enable",
+            "disable"
+          ],
+          "name": "status",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:rm",
+      "id": "device:public-url",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -1964,34 +2022,27 @@
         "build",
         "commands",
         "device",
-        "rm.js"
+        "public-url.js"
       ]
     },
-    "device:shutdown": {
+    "device:purge": {
       "aliases": [],
       "args": {
         "uuid": {
-          "description": "the uuid of the device to shutdown",
+          "description": "comma-separated list (no blank spaces) of device UUIDs",
           "name": "uuid",
           "required": true
         }
       },
-      "description": "Shutdown a device.\n\nRemotely shutdown a device.",
+      "description": "Purge data from a device.\n\nPurge data from a device.\nThis will clear the device's \"/data\" directory.\n\nMultiple devices may be specified with a comma-separated list\nof values (no spaces).",
       "examples": [
-        "$ balena device shutdown 23c73a1"
+        "$ balena device purge 23c73a1",
+        "$ balena device purge 55d43b3,23c73a1"
       ],
-      "flags": {
-        "force": {
-          "char": "f",
-          "description": "force action if the update lock is set",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:shutdown",
+      "id": "device:purge",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
@@ -2003,15 +2054,263 @@
         "build",
         "commands",
         "device",
-        "shutdown.js"
+        "purge.js"
       ]
     },
-    "device:ssh": {
+    "device:reboot": {
       "aliases": [],
       "args": {
-        "fleetOrDevice": {
-          "description": "fleet name/slug, device uuid, or address of local device",
-          "name": "fleetOrDevice",
+        "uuid": {
+          "description": "the uuid of the device to reboot",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Restart a device.\n\nRemotely reboot a device.",
+      "examples": [
+        "$ balena device reboot 23c73a1"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "force action if the update lock is set",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:reboot",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "device",
+        "reboot.js"
+      ]
+    },
+    "device:register": {
+      "aliases": [],
+      "args": {
+        "fleet": {
+          "description": "fleet name or slug (preferred)",
+          "name": "fleet",
+          "required": true
+        }
+      },
+      "description": "Register a new device.\n\nRegister a new device with a balena fleet.\n\nIf --uuid is not provided, a new UUID will be automatically assigned.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
+      "examples": [
+        "$ balena device register MyFleet",
+        "$ balena device register MyFleet --uuid <uuid>",
+        "$ balena device register myorg/myfleet --uuid <uuid>",
+        "$ balena device register myorg/myfleet --uuid <uuid> --deviceType <deviceTypeSlug>"
+      ],
+      "flags": {
+        "uuid": {
+          "char": "u",
+          "description": "custom uuid",
+          "name": "uuid",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "deviceType": {
+          "description": "device type slug (run 'balena device-type list' for possible values)",
+          "name": "deviceType",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:register",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "device",
+        "register.js"
+      ]
+    },
+    "device:rename": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "the uuid of the device to rename",
+          "name": "uuid",
+          "required": true
+        },
+        "newName": {
+          "description": "the new name for the device",
+          "name": "newName"
+        }
+      },
+      "description": "Rename a device.\n\nRename a device.\n\nNote, if the name is omitted, it will be prompted for interactively.",
+      "examples": [
+        "$ balena device rename 7cf02a6",
+        "$ balena device rename 7cf02a6 MyPi"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:rename",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "device",
+        "rename.js"
+      ]
+    },
+    "device:restart": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "comma-separated list (no blank spaces) of device UUIDs to restart",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Restart containers on a device.\n\nRestart containers on a device.\nIf the --service flag is provided, then only those services' containers\nwill be restarted, otherwise all containers on the device will be restarted.\n\nMultiple devices and services may be specified with a comma-separated list\nof values (no spaces).\n\nNote this does not reboot the device, to do so use instead `balena device reboot`.",
+      "examples": [
+        "$ balena device restart 23c73a1",
+        "$ balena device restart 55d43b3,23c73a1",
+        "$ balena device restart 23c73a1 --service myService",
+        "$ balena device restart 23c73a1 -s myService1,myService2"
+      ],
+      "flags": {
+        "service": {
+          "char": "s",
+          "description": "comma-separated list (no blank spaces) of service names to restart",
+          "name": "service",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:restart",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "device",
+        "restart.js"
+      ]
+    },
+    "device:rm": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "comma-separated list (no blank spaces) of device UUIDs to be removed",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Remove one or more devices.\n\nRemove one or more devices from balena.\n\nNote this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` option.",
+      "examples": [
+        "$ balena device rm 7cf02a6",
+        "$ balena device rm 7cf02a6,dc39e52",
+        "$ balena device rm 7cf02a6 --yes"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "answer \"yes\" to all questions (non interactive use)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:rm",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "device",
+        "rm.js"
+      ]
+    },
+    "device:shutdown": {
+      "aliases": [],
+      "args": {
+        "uuid": {
+          "description": "the uuid of the device to shutdown",
+          "name": "uuid",
+          "required": true
+        }
+      },
+      "description": "Shutdown a device.\n\nRemotely shutdown a device.",
+      "examples": [
+        "$ balena device shutdown 23c73a1"
+      ],
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "force action if the update lock is set",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "device:shutdown",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "device",
+        "shutdown.js"
+      ]
+    },
+    "device:ssh": {
+      "aliases": [],
+      "args": {
+        "fleetOrDevice": {
+          "description": "fleet name/slug, device uuid, or address of local device",
+          "name": "fleetOrDevice",
           "required": true
         },
         "service": {
@@ -2222,319 +2521,20 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "device:tunnel",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "primary": true,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "device",
-        "tunnel.js"
-      ]
-    },
-    "env:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List the environment or config variables of a fleet, device or service.\n\nList the environment or configuration variables of a fleet, device or\nservice, as selected by the respective command-line options. (A service\ncorresponds to a Docker image/container in a microservices fleet.)\n\nThe results include fleet-wide (multiple devices), device-specific (multiple\nservices on a specific device) and service-specific variables that apply to the\nselected fleet, device or service. It can be thought of as including inherited\nvariables; for example, a service inherits device-wide variables, and a device\ninherits fleet-wide variables.\n\nThe printed output may include DEVICE and/or SERVICE columns to distinguish\nbetween fleet-wide, device-specific and service-specific variables.\nAn asterisk in these columns indicates that the variable applies to\n\"all devices\" or \"all services\".\n\nThe --config option is used to list \"configuration variables\" that control\nbalena platform features, as opposed to custom environment variables defined\nby the user. The --config and the --service options are mutually exclusive\nbecause configuration variables cannot be set for specific services.\n\nWhen --json is used, an empty JSON array ([]) is printed instead of an error \nmessage when no variables exist for the given query. When querying variables \nfor a device, note that the fleet name may be null in JSON output \n(or 'N/A' in tabular output) if the fleet that the device belonged to is no \nlonger accessible by the current user (for example, in case the current user \nwas removed from the fleet by the fleet's owner).\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
-      "examples": [
-        "$ balena env list --fleet myorg/myfleet",
-        "$ balena env list --fleet MyFleet --service MyService",
-        "$ balena env list --fleet MyFleet --config",
-        "$ balena env list --device 7cf02a6",
-        "$ balena env list --device 7cf02a6 --service MyService"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "fleet": {
-          "char": "f",
-          "description": "fleet name or slug (preferred)",
-          "exclusive": [
-            "device"
-          ],
-          "name": "fleet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "config": {
-          "char": "c",
-          "description": "show configuration variables only",
-          "exclusive": [
-            "service"
-          ],
-          "name": "config",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "device UUID",
-          "exclusive": [
-            "fleet"
-          ],
-          "name": "device",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "service": {
-          "char": "s",
-          "description": "service name",
-          "exclusive": [
-            "config"
-          ],
-          "name": "service",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "env:list",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "env",
-        "list.js"
-      ]
-    },
-    "env:rename": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "variable's numeric database ID",
-          "name": "id",
-          "required": true
-        },
-        "value": {
-          "description": "variable value; if omitted, use value from this process' environment",
-          "name": "value",
-          "required": true
-        }
-      },
-      "description": "Change the value of a config or env var for a fleet, device or service.\n\nChange the value of a configuration or environment variable for a fleet,\ndevice or service, as selected by command-line options.\n\nVariables are selected by their database ID (as reported by the 'balena env list'\ncommand) and one of six database \"resource types\":\n\n- fleet environment variable\n- fleet configuration variable (--config)\n- fleet service variable (--service)\n- device environment variable (--device)\n- device configuration variable (--device --config)\n- device service variable (--device --service)\n\nThe --device option selects a device-specific variable instead of a fleet\nvariable.\n\nThe --config option selects a configuration variable. Configuration variable\nnames typically start with the 'BALENA_' or 'RESIN_' prefixes and are used to\nconfigure balena platform features.\n\nThe --service option selects a service variable, which is an environment variable\nthat applies to a specifc service (container) in a microservices (multicontainer)\nfleet.\n\nThe --service and --config options cannot be used together, but they can be\nused alongside the --device option to select a device-specific service or\nconfiguration variable.",
-      "examples": [
-        "$ balena env rename 123123 emacs",
-        "$ balena env rename 234234 emacs --service",
-        "$ balena env rename 345345 emacs --device",
-        "$ balena env rename 456456 emacs --device --service",
-        "$ balena env rename 567567 1 --config",
-        "$ balena env rename 678678 1 --device --config"
-      ],
-      "flags": {
-        "config": {
-          "char": "c",
-          "description": "select a configuration variable (may be used together with the --device option)",
-          "exclusive": [
-            "service"
-          ],
-          "name": "config",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "select a device-specific variable instead of a fleet variable",
-          "name": "device",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "service": {
-          "char": "s",
-          "description": "select a service variable (may be used together with the --device option)",
-          "exclusive": [
-            "config"
-          ],
-          "name": "service",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "env:rename",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "env",
-        "rename.js"
-      ]
-    },
-    "env:rm": {
-      "aliases": [],
-      "args": {
-        "id": {
-          "description": "variable's numeric database ID",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Remove a config or env var from a fleet, device or service.\n\nRemove a configuration or environment variable from a fleet, device\nor service, as selected by command-line options.\n\nVariables are selected by their database ID (as reported by the 'balena env list'\ncommand) and one of six database \"resource types\":\n\n- fleet environment variable\n- fleet configuration variable (--config)\n- fleet service variable (--service)\n- device environment variable (--device)\n- device configuration variable (--device --config)\n- device service variable (--device --service)\n\nThe --device option selects a device-specific variable instead of a fleet\nvariable.\n\nThe --config option selects a configuration variable. Configuration variable\nnames typically start with the 'BALENA_' or 'RESIN_' prefixes and are used to\nconfigure balena platform features.\n\nThe --service option selects a service variable, which is an environment variable\nthat applies to a specifc service (container) in a microservices (multicontainer)\nfleet.\n\nThe --service and --config options cannot be used together, but they can be\nused alongside the --device option to select a device-specific service or\nconfiguration variable.\n\nInteractive confirmation is normally asked before the variable is deleted.\nThe --yes option disables this behavior.",
-      "examples": [
-        "$ balena env rm 123123",
-        "$ balena env rm 234234 --yes",
-        "$ balena env rm 345345 --config",
-        "$ balena env rm 456456 --service",
-        "$ balena env rm 567567 --device",
-        "$ balena env rm 678678 --device --config",
-        "$ balena env rm 789789 --device --service --yes"
-      ],
-      "flags": {
-        "config": {
-          "char": "c",
-          "description": "select a configuration variable (may be used together with the --device option)",
-          "exclusive": [
-            "service"
-          ],
-          "name": "config",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "device": {
-          "char": "d",
-          "description": "select a device-specific variable instead of a fleet variable",
-          "name": "device",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "service": {
-          "char": "s",
-          "description": "select a service variable (may be used together with the --device option)",
-          "exclusive": [
-            "config"
-          ],
-          "name": "service",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "do not prompt for confirmation before deleting the variable",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "env:rm",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "env",
-        "rm.js"
-      ]
-    },
-    "env:set": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "environment or config variable name",
-          "name": "name",
-          "required": true
-        },
-        "value": {
-          "description": "variable value; if omitted, use value from this process' environment",
-          "name": "value",
-          "required": false
-        }
-      },
-      "description": "Add or update env or config variable to fleets, devices or services.\n\nAdd or update an environment or config variable to one or more fleets, devices or\nservices, as selected by the respective command-line options. Either the\n--fleet or the --device option must be provided,  and either may be be\nused alongside the --service option to define a service-specific variable.\n(A service corresponds to a Docker image/container in a microservices fleet.)\nWhen the --service option is used in conjunction with the --device option,\nthe service variable applies to the selected device only.  Otherwise, it\napplies to all devices of the selected fleet. If the --service option is\nomitted, the variable applies to all services.\n\nIf VALUE is omitted, the CLI will attempt to use the value of the environment\nvariable of same name in the CLI process' environment. In this case, a warning\nmessage will be printed. Use `--quiet` to suppress it.\n\n'BALENA_' or 'RESIN_' are reserved variable name prefixes used to identify\n\"configuration variables\". Configuration variables control balena platform\nfeatures and are treated specially by balenaOS and the balena supervisor\nrunning on devices. They are also stored differently in the balenaCloud API\ndatabase. Configuration variables cannot be set for specific services,\ntherefore the --service option cannot be used when the variable name starts\nwith a reserved prefix. When defining custom fleet variables, please avoid\nthese reserved prefixes.\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
-      "examples": [
-        "$ balena env set TERM --fleet MyFleet",
-        "$ balena env set EDITOR vim -f myorg/myfleet",
-        "$ balena env set EDITOR vim --fleet MyFleet,MyFleet2",
-        "$ balena env set EDITOR vim --fleet MyFleet --service MyService",
-        "$ balena env set EDITOR vim --fleet MyFleet,MyFleet2 --service MyService,MyService2",
-        "$ balena env set EDITOR vim --device 7cf02a6",
-        "$ balena env set EDITOR vim --device 7cf02a6,d6f1433",
-        "$ balena env set EDITOR vim --device 7cf02a6 --service MyService",
-        "$ balena env set EDITOR vim --device 7cf02a6,d6f1433 --service MyService,MyService2"
-      ],
-      "flags": {
-        "fleet": {
-          "char": "f",
-          "description": "fleet name or slug (preferred)",
-          "exclusive": [
-            "device"
-          ],
-          "name": "fleet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "device": {
-          "char": "d",
-          "description": "device UUID",
-          "exclusive": [
-            "fleet"
-          ],
-          "name": "device",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "quiet": {
-          "char": "q",
-          "description": "suppress warning messages",
-          "name": "quiet",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "service": {
-          "char": "s",
-          "description": "service name",
-          "name": "service",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "env:set",
+      "id": "device:tunnel",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
+      "primary": true,
+      "authenticated": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "env",
-        "set.js"
+        "device",
+        "tunnel.js"
       ]
     },
     "fleet:create": {
@@ -2916,6 +2916,39 @@
         "osinit.js"
       ]
     },
+    "leave": {
+      "aliases": [],
+      "args": {
+        "deviceIpOrHostname": {
+          "description": "the device IP or hostname",
+          "name": "deviceIpOrHostname"
+        }
+      },
+      "description": "Remove a local device from its balena fleet.\n\nRemove a local device from its balena fleet, causing the device to\n\"leave\" the server it is provisioned on. This effectively makes the device\n\"unmanaged\". The device must be running balenaOS.\n\nThe device entry on the server is preserved after running this command,\nso the device can subsequently re-join the server if needed.\n\nIf you don't specify a device hostname or IP, this command will automatically\nscan the local network for balenaOS devices and prompt you to select one\nfrom an interactive picker. This may require administrator/root privileges.",
+      "examples": [
+        "$ balena leave",
+        "$ balena leave balena.local",
+        "$ balena leave 192.168.1.25"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "leave",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "primary": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "leave",
+        "index.js"
+      ]
+    },
     "join": {
       "aliases": [],
       "args": {
@@ -2969,39 +3002,6 @@
         "index.js"
       ]
     },
-    "leave": {
-      "aliases": [],
-      "args": {
-        "deviceIpOrHostname": {
-          "description": "the device IP or hostname",
-          "name": "deviceIpOrHostname"
-        }
-      },
-      "description": "Remove a local device from its balena fleet.\n\nRemove a local device from its balena fleet, causing the device to\n\"leave\" the server it is provisioned on. This effectively makes the device\n\"unmanaged\". The device must be running balenaOS.\n\nThe device entry on the server is preserved after running this command,\nso the device can subsequently re-join the server if needed.\n\nIf you don't specify a device hostname or IP, this command will automatically\nscan the local network for balenaOS devices and prompt you to select one\nfrom an interactive picker. This may require administrator/root privileges.",
-      "examples": [
-        "$ balena leave",
-        "$ balena leave balena.local",
-        "$ balena leave 192.168.1.25"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "leave",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "primary": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "leave",
-        "index.js"
-      ]
-    },
     "local:configure": {
       "aliases": [],
       "args": {
@@ -4074,6 +4074,30 @@
         "validate.js"
       ]
     },
+    "settings": {
+      "aliases": [],
+      "args": {},
+      "description": "Print current settings.\n\nUse this command to display the current balena CLI settings.",
+      "examples": [
+        "$ balena settings"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "settings",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "settings",
+        "index.js"
+      ]
+    },
     "release-asset:delete": {
       "aliases": [],
       "args": {
@@ -4289,27 +4313,64 @@
         "upload.js"
       ]
     },
-    "settings": {
+    "support": {
       "aliases": [],
-      "args": {},
-      "description": "Print current settings.\n\nUse this command to display the current balena CLI settings.",
+      "args": {
+        "action": {
+          "description": "enable|disable support access",
+          "name": "action",
+          "options": [
+            "enable",
+            "disable"
+          ]
+        }
+      },
+      "description": "Grant or revoke support access for devices or fleets.\n\nGrant or revoke balena support agent access to devices or fleets\non balenaCloud. (This command does not apply to openBalena.)\nAccess will be automatically revoked once the specified duration has elapsed.\n\nDuration defaults to 24h, but can be specified using --duration flag in days\nor hours, e.g. '12h', '2d'.\n\nBoth --device and --fleet flags accept multiple values, specified as\na comma-separated list (with no spaces).\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
       "examples": [
-        "$ balena settings"
+        "balena support enable --device ab346f,cd457a --duration 3d",
+        "balena support enable --fleet myFleet --duration 12h",
+        "balena support disable -f myorg/myfleet"
       ],
-      "flags": {},
+      "flags": {
+        "device": {
+          "char": "d",
+          "description": "comma-separated list (no spaces) of device UUIDs",
+          "name": "device",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "fleet": {
+          "char": "f",
+          "description": "comma-separated list (no spaces) of fleet names or slugs (preferred)",
+          "name": "fleet",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "duration": {
+          "char": "t",
+          "description": "length of time to enable support for, in (h)ours or (d)ays, e.g. 12h, 2d",
+          "name": "duration",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "settings",
+      "id": "support",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
+      "authenticated": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "settings",
+        "support",
         "index.js"
       ]
     },
@@ -4448,89 +4509,6 @@
         "rm.js"
       ]
     },
-    "support": {
-      "aliases": [],
-      "args": {
-        "action": {
-          "description": "enable|disable support access",
-          "name": "action",
-          "options": [
-            "enable",
-            "disable"
-          ]
-        }
-      },
-      "description": "Grant or revoke support access for devices or fleets.\n\nGrant or revoke balena support agent access to devices or fleets\non balenaCloud. (This command does not apply to openBalena.)\nAccess will be automatically revoked once the specified duration has elapsed.\n\nDuration defaults to 24h, but can be specified using --duration flag in days\nor hours, e.g. '12h', '2d'.\n\nBoth --device and --fleet flags accept multiple values, specified as\na comma-separated list (with no spaces).\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).",
-      "examples": [
-        "balena support enable --device ab346f,cd457a --duration 3d",
-        "balena support enable --fleet myFleet --duration 12h",
-        "balena support disable -f myorg/myfleet"
-      ],
-      "flags": {
-        "device": {
-          "char": "d",
-          "description": "comma-separated list (no spaces) of device UUIDs",
-          "name": "device",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "fleet": {
-          "char": "f",
-          "description": "comma-separated list (no spaces) of fleet names or slugs (preferred)",
-          "name": "fleet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "duration": {
-          "char": "t",
-          "description": "length of time to enable support for, in (h)ours or (d)ays, e.g. 12h, 2d",
-          "name": "duration",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "support",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "support",
-        "index.js"
-      ]
-    },
-    "util:available-drives": {
-      "aliases": [],
-      "args": {},
-      "description": "List available drives.\n\nList available drives which are usable for writing an OS image to.\nDoes not list system drives.",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "util:available-drives",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "offlineCompatible": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "util",
-        "available-drives.js"
-      ]
-    },
     "tag:list": {
       "aliases": [],
       "args": {},
@@ -4775,6 +4753,28 @@
         "whoami",
         "index.js"
       ]
+    },
+    "util:available-drives": {
+      "aliases": [],
+      "args": {},
+      "description": "List available drives.\n\nList available drives which are usable for writing an OS image to.\nDoes not list system drives.",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "util:available-drives",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "offlineCompatible": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "util",
+        "available-drives.js"
+      ]
     }
   },
   "version": "23.2.12"