balena-cli 23.2.5-build-update-docker-progress-5-4-0-224a174b777b629fd139c0cd1128c1df40553fb5-1 → 23.2.5-build-os-configure-flasher-b7a7baa53519fec52b36c41d9edb9006e27e5a89-3

package/CHANGELOG.md

@@ -8,67 +8,15 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 
 <details>
-<summary> Update docker-progress to 5.4.0 [Thodoris Greasidis] </summary>
+<summary> os configure: Fix detecting the OS version of flasher images [Thodoris Greasidis] </summary>
 
-> ### docker-progress-5.4.0 - 2025-12-03
+> ### balena-device-init-8.2.0 - 2025-12-03
 > 
-> * pull/push/build: Support detecting the result digest when pushing only the reference of a pre-built image [Thodoris Greasidis]
-> 
-> ### docker-progress-5.3.4 - 2025-12-03
-> 
-> * pull: fix digest hash parsing [Tuetuopay]
-> 
-> ### docker-progress-5.3.3 - 2025-11-28
-> 
-> * Update flowzone workflow to allow external contributions [Thodoris Greasidis]
-> 
-> ### docker-progress-5.3.2 - 2025-11-28
-> 
-> * Fix TS errors for the latest dockerode [Thodoris Greasidis]
-> 
-> ### docker-progress-5.3.1 - 2025-05-15
-> 
-> * Make abortSignal optional in pull/push options [Felipe Lalanne]
-> 
-> ### docker-progress-5.3.0 - 2025-05-12
-> 
-> * Support AbortSignal option for image push/pull [Christina Ying Wang]
-> 
-> ### docker-progress-5.2.7 - 2025-04-10
-> 
-> * Update @balena/lint to 9.x [Pagan Gazzard]
-> 
-> ### docker-progress-5.2.6 - 2025-04-02
-> 
-> * Update dependency rimraf to v6 [balena-renovate[bot]]
-> 
-> ### docker-progress-5.2.5 - 2025-03-25
-> 
-> * Update dependency @balena/lint to v8 [balena-renovate[bot]]
-> 
-> ### docker-progress-5.2.4 - 2025-02-12
-> 
-> * Propagate NodeJS Error from stream directly [Christina Ying Wang]
-> 
-> ### docker-progress-5.2.3 - 2024-01-05
-> 
-> * Make use of nullish coalescing [Pagan Gazzard]
-> 
-> ### docker-progress-5.2.2 - 2024-01-05
-> 
-> * Reduce lodash usage [Pagan Gazzard]
-> 
-> ### docker-progress-5.2.1 - 2024-01-05
-> 
-> * Update dependencies [Pagan Gazzard]
-> 
-> ### docker-progress-5.2.0 - Invalid date
-> 
-> * Add support for tracking delta generation progress [Akis Kesoglou]
-> 
-> ### docker-progress-5.1.4 - Invalid date
-> 
-> * Build with Flowzone [Akis Kesoglou]
+> * Add test for the getImageOsVersion() function on GPT flasher images [Thodoris Greasidis]
+> * Deprecate support for the edison [Thodoris Greasidis]
+> * getImageOsVersion: Support detecting the version on flasher images [Thodoris Greasidis]
+> * Add test for the getImageOsVersion() function on raw DT images [Thodoris Greasidis]
+> * tests/images/raspberrypi-os2.img: Rename the RESIN-BOOT partition to resin-boot as it is supposed to be [Thodoris Greasidis]
 > 
 
 </details>

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "balena-cli",
-  "version": "23.2.5-build-update-docker-progress-5-4-0-224a174b777b629fd139c0cd1128c1df40553fb5-1",
+  "version": "23.2.5-build-os-configure-flasher-b7a7baa53519fec52b36c41d9edb9006e27e5a89-3",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "balena-cli",
-      "version": "23.2.5-build-update-docker-progress-5-4-0-224a174b777b629fd139c0cd1128c1df40553fb5-1",
+      "version": "23.2.5-build-os-configure-flasher-b7a7baa53519fec52b36c41d9edb9006e27e5a89-3",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {
@@ -20,7 +20,7 @@
         "@oclif/plugin-version": "^2.2.32",
         "@sentry/node": "^10.17.0",
         "balena-config-json": "^4.2.7",
-        "balena-device-init": "^8.1.14",
+        "balena-device-init": "^8.2.0",
         "balena-errors": "^4.7.3",
         "balena-image-fs": "^7.5.2",
         "balena-preload": "^18.0.5",
@@ -37,7 +37,7 @@
         "date-fns": "^4.1.0",
         "denymount": "^2.3.0",
         "docker-modem": "^5.0.6",
-        "docker-progress": "^5.4.0",
+        "docker-progress": "^5.1.3",
         "dockerode": "^4.0.5",
         "ejs": "^3.1.6",
         "etcher-sdk": "^10.0.0",
@@ -12600,9 +12600,9 @@
       }
     },
     "node_modules/balena-device-init": {
-      "version": "8.1.14",
-      "resolved": "https://registry.npmjs.org/balena-device-init/-/balena-device-init-8.1.14.tgz",
-      "integrity": "sha512-aanHWsXhlfzo5IpAuBjLGvAPgCJhKEO8pJ1szL7FKv1d9fIuonAz9ueNFk4H46UlNmpiqo1a6A+jbzUkR7EfHQ==",
+      "version": "8.2.0",
+      "resolved": "https://registry.npmjs.org/balena-device-init/-/balena-device-init-8.2.0.tgz",
+      "integrity": "sha512-No8AIt+L5ytJdNkTJTy4XU3JX/bS92nO7e42YModInT1mqYuaqQOgCTSuGE5/1uAIE6WhQRGeZ+/hE5catFrww==",
       "license": "Apache-2.0",
       "dependencies": {
         "balena-config-json": "^4.2.0",
@@ -14613,7 +14613,6 @@
       "resolved": "https://registry.npmjs.org/docker-modem/-/docker-modem-5.0.6.tgz",
       "integrity": "sha512-ens7BiayssQz/uAxGzH8zGXCtiV24rRWXdjNha5V4zSOcxmAZsfGVm/PPFbwQdqEkDnhG+SyR9E3zSHUbOKXBQ==",
       "license": "Apache-2.0",
-      "peer": true,
       "dependencies": {
         "debug": "^4.1.1",
         "readable-stream": "^3.5.0",
@@ -14638,21 +14637,13 @@
       }
     },
     "node_modules/docker-progress": {
-      "version": "5.4.0",
-      "resolved": "https://registry.npmjs.org/docker-progress/-/docker-progress-5.4.0.tgz",
-      "integrity": "sha512-AzH4jOpndhfB3wb2RnPOb1KEcyWmcHHR44K0g4qE8oeihmFjc/CnGSuqB2LCivL8j2Yeeduvg6LQyV24XMBtjw==",
-      "license": "Apache-2.0",
+      "version": "5.1.3",
+      "resolved": "https://registry.npmjs.org/docker-progress/-/docker-progress-5.1.3.tgz",
+      "integrity": "sha512-Ou+o4ISCxMvuoeG09S/irjgleLdG4ZhNiqo31p8vOzDfZm5+JaS2ouHo4lc4kXKqTN6c5eCm+62oRGoaPLDY1A==",
       "dependencies": {
-        "@types/dockerode": "^3.3.23",
+        "@types/dockerode": "^3.3.9",
         "JSONStream": "^1.3.5",
         "lodash": "^4.17.21"
-      },
-      "engines": {
-        "node": ">=16.0.0"
-      },
-      "peerDependencies": {
-        "docker-modem": ">=3.0.3",
-        "dockerode": ">=3.3.1"
       }
     },
     "node_modules/dockerfile-ast": {
@@ -14673,7 +14664,6 @@
       "resolved": "https://registry.npmjs.org/dockerode/-/dockerode-4.0.9.tgz",
       "integrity": "sha512-iND4mcOWhPaCNh54WmK/KoSb35AFqPAUWFMffTQcp52uQt36b5uNwEJTSXntJZBbeGad72Crbi/hvDIv6us/6Q==",
       "license": "Apache-2.0",
-      "peer": true,
       "dependencies": {
         "@balena/dockerignore": "^1.0.2",
         "@grpc/grpc-js": "^1.11.1",

package/oclif.manifest.json

@@ -2916,59 +2916,6 @@
         "osinit.js"
       ]
     },
-    "join": {
-      "aliases": [],
-      "args": {
-        "deviceIpOrHostname": {
-          "description": "the IP or hostname of device",
-          "name": "deviceIpOrHostname"
-        }
-      },
-      "description": "Move a local device to a fleet on another balena server.\n\nMove a local device to a fleet on another balena server, causing\nthe device to \"join\" the new server. The device must be running balenaOS.\n\nFor example, you could provision a device against an openBalena installation\nwhere you perform end-to-end tests and then move it to balenaCloud when it's\nready for production.\n\nTo move a device between fleets on the same server, use the\n`balena device move` command instead of `balena join`.\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.\nLikewise, if the fleet option is not provided then a picker will be shown.\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 join",
-        "$ balena join balena.local",
-        "$ balena join balena.local --fleet MyFleet",
-        "$ balena join balena.local -f myorg/myfleet",
-        "$ balena join 192.168.1.25",
-        "$ balena join 192.168.1.25 --fleet MyFleet"
-      ],
-      "flags": {
-        "fleet": {
-          "char": "f",
-          "description": "fleet name or slug (preferred)",
-          "name": "fleet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "pollInterval": {
-          "char": "i",
-          "description": "the interval in minutes to check for updates",
-          "name": "pollInterval",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "join",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "primary": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "join",
-        "index.js"
-      ]
-    },
     "leave": {
       "aliases": [],
       "args": {
@@ -3002,86 +2949,57 @@
         "index.js"
       ]
     },
-    "local:configure": {
-      "aliases": [],
-      "args": {
-        "target": {
-          "description": "path of drive or image to configure",
-          "name": "target",
-          "required": true
-        }
-      },
-      "description": "(Re)configure a balenaOS drive or image.\n\nConfigure or reconfigure a balenaOS drive or image.",
-      "examples": [
-        "$ balena local configure /dev/sdc",
-        "$ balena local configure path/to/image.img"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "local:configure",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "root": true,
-      "offlineCompatible": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "local",
-        "configure.js"
-      ]
-    },
-    "local:flash": {
+    "join": {
       "aliases": [],
       "args": {
-        "image": {
-          "description": "path to OS image",
-          "name": "image",
-          "required": true
+        "deviceIpOrHostname": {
+          "description": "the IP or hostname of device",
+          "name": "deviceIpOrHostname"
         }
       },
-      "description": "Flash an image to a drive.\n\nFlash a balenaOS image to a drive.\nImage file may be one of: .img|.zip|.gz|.bz2|.xz\n\nIf --drive is not specified, then it will interactively\nshow a list of available drives for selection.",
+      "description": "Move a local device to a fleet on another balena server.\n\nMove a local device to a fleet on another balena server, causing\nthe device to \"join\" the new server. The device must be running balenaOS.\n\nFor example, you could provision a device against an openBalena installation\nwhere you perform end-to-end tests and then move it to balenaCloud when it's\nready for production.\n\nTo move a device between fleets on the same server, use the\n`balena device move` command instead of `balena join`.\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.\nLikewise, if the fleet option is not provided then a picker will be shown.\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 local flash path/to/balenaos.img",
-        "$ balena local flash path/to/balenaos.img --drive /dev/disk2",
-        "$ balena local flash path/to/balenaos.img --drive /dev/disk2 --yes"
+        "$ balena join",
+        "$ balena join balena.local",
+        "$ balena join balena.local --fleet MyFleet",
+        "$ balena join balena.local -f myorg/myfleet",
+        "$ balena join 192.168.1.25",
+        "$ balena join 192.168.1.25 --fleet MyFleet"
       ],
       "flags": {
-        "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",
+        "fleet": {
+          "char": "f",
+          "description": "fleet name or slug (preferred)",
+          "name": "fleet",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "yes": {
-          "char": "y",
-          "description": "answer \"yes\" to all questions (non interactive use)",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "pollInterval": {
+          "char": "i",
+          "description": "the interval in minutes to check for updates",
+          "name": "pollInterval",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "local:flash",
+      "id": "join",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "offlineCompatible": true,
+      "authenticated": true,
+      "primary": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "local",
-        "flash.js"
+        "join",
+        "index.js"
       ]
     },
     "login": {
@@ -3209,29 +3127,86 @@
         "index.js"
       ]
     },
-    "organization:list": {
+    "local:configure": {
       "aliases": [],
-      "args": {},
-      "description": "List all organizations.\n\nlist all the organizations that you are a member of.",
+      "args": {
+        "target": {
+          "description": "path of drive or image to configure",
+          "name": "target",
+          "required": true
+        }
+      },
+      "description": "(Re)configure a balenaOS drive or image.\n\nConfigure or reconfigure a balenaOS drive or image.",
       "examples": [
-        "$ balena organization list"
+        "$ balena local configure /dev/sdc",
+        "$ balena local configure path/to/image.img"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "organization:list",
+      "id": "local:configure",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "authenticated": true,
+      "root": true,
+      "offlineCompatible": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "organization",
-        "list.js"
+        "local",
+        "configure.js"
+      ]
+    },
+    "local:flash": {
+      "aliases": [],
+      "args": {
+        "image": {
+          "description": "path to OS image",
+          "name": "image",
+          "required": true
+        }
+      },
+      "description": "Flash an image to a drive.\n\nFlash a balenaOS image to a drive.\nImage file may be one of: .img|.zip|.gz|.bz2|.xz\n\nIf --drive is not specified, then it will interactively\nshow a list of available drives for selection.",
+      "examples": [
+        "$ balena local flash path/to/balenaos.img",
+        "$ balena local flash path/to/balenaos.img --drive /dev/disk2",
+        "$ balena local flash path/to/balenaos.img --drive /dev/disk2 --yes"
+      ],
+      "flags": {
+        "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)",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "local:flash",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "offlineCompatible": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "local",
+        "flash.js"
       ]
     },
     "logout": {
@@ -3258,134 +3233,29 @@
         "index.js"
       ]
     },
-    "preload": {
+    "organization:list": {
       "aliases": [],
-      "args": {
-        "image": {
-          "description": "the image file path",
-          "name": "image",
-          "required": true
-        }
-      },
-      "description": "Preload a release on a disk image (or Edison zip archive).\n\nPreload a release (service images/containers) from a balena fleet, and optionally\na balenaOS splash screen, in a previously downloaded '.img' balenaOS image file\nin the local disk (a zip file is only accepted for the Intel Edison device type).\nAfter preloading, the balenaOS image file can be flashed to a device's SD card.\nWhen the device boots, it will not need to download the release, as it was\npreloaded. This is usually combined with release pinning\n(https://www.balena.io/docs/learn/deploy/release-strategy/release-policy/)\nto avoid the device downloading a newer release straight away, if available.\nCheck also the Preloading and Preregistering section of the balena CLI's advanced\nmasterclass document:\nhttps://www.balena.io/docs/learn/more/masterclasses/advanced-cli/#5-preloading-and-preregistering\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\nNote that the this command requires Docker to be installed, as further detailed\nin the balena CLI's installation instructions:\nhttps://github.com/balena-io/balena-cli/blob/master/INSTALL.md\nThe `--dockerHost` and `--dockerPort` flags allow a remote Docker engine to\nbe used, however the image file must be accessible to the remote Docker engine\non the same path given on the command line. This is because Docker's bind mount\nfeature is used to \"share\" the image with a container that performs the preload.",
+      "args": {},
+      "description": "List all organizations.\n\nlist all the organizations that you are a member of.",
       "examples": [
-        "$ balena preload balena.img --fleet MyFleet --commit e1f2592fc6ee949e68756d4f4a48e49bff8d72a0",
-        "$ balena preload balena.img --fleet myorg/myfleet --splash-image image.png",
-        "$ balena preload balena.img"
+        "$ balena organization list"
       ],
-      "flags": {
-        "fleet": {
-          "char": "f",
-          "description": "fleet name or slug (preferred)",
-          "name": "fleet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "commit": {
-          "char": "c",
-          "description": "The commit hash of the release to preload. Use \"current\" to specify the current\nrelease (ignored if no appId is given). The current release is usually also the\nlatest, but can be pinned to a specific release. See:\nhttps://www.balena.io/docs/learn/deploy/release-strategy/release-policy/\nhttps://www.balena.io/docs/learn/more/masterclasses/fleet-management/#63-pin-using-the-api\nhttps://github.com/balena-io-examples/staged-releases",
-          "name": "commit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "splash-image": {
-          "char": "s",
-          "description": "path to a png image to replace the splash screen",
-          "name": "splash-image",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dont-check-arch": {
-          "description": "disable architecture compatibility check between image and fleet",
-          "name": "dont-check-arch",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "pin-device-to-release": {
-          "char": "p",
-          "description": "pin the preloaded device to the preloaded release on provision",
-          "name": "pin-device-to-release",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "additional-space": {
-          "description": "expand the image by this amount of bytes instead of automatically estimating the required amount",
-          "name": "additional-space",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "add-certificate": {
-          "description": "Add the given certificate (in PEM format) to /etc/ssl/certs in the preloading container.\nThe file name must end with '.crt' and must not be already contained in the preloader's\n/etc/ssl/certs folder.\nCan be repeated to add multiple certificates.",
-          "name": "add-certificate",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "docker": {
-          "char": "P",
-          "description": "Path to a local docker socket (e.g. /var/run/docker.sock)",
-          "name": "docker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dockerHost": {
-          "char": "h",
-          "description": "Docker daemon hostname or IP address (dev machine or balena device) ",
-          "name": "dockerHost",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dockerPort": {
-          "description": "Docker daemon TCP port number (hint: 2375 for balena devices)",
-          "name": "dockerPort",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "ca": {
-          "description": "Docker host TLS certificate authority file",
-          "name": "ca",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cert": {
-          "description": "Docker host TLS certificate file",
-          "name": "cert",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "key": {
-          "description": "Docker host TLS key file",
-          "name": "key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preload",
+      "id": "organization:list",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
       "authenticated": true,
-      "primary": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "preload",
-        "index.js"
+        "organization",
+        "list.js"
       ]
     },
     "os:configure": {
@@ -3727,6 +3597,136 @@
         "versions.js"
       ]
     },
+    "preload": {
+      "aliases": [],
+      "args": {
+        "image": {
+          "description": "the image file path",
+          "name": "image",
+          "required": true
+        }
+      },
+      "description": "Preload a release on a disk image (or Edison zip archive).\n\nPreload a release (service images/containers) from a balena fleet, and optionally\na balenaOS splash screen, in a previously downloaded '.img' balenaOS image file\nin the local disk (a zip file is only accepted for the Intel Edison device type).\nAfter preloading, the balenaOS image file can be flashed to a device's SD card.\nWhen the device boots, it will not need to download the release, as it was\npreloaded. This is usually combined with release pinning\n(https://www.balena.io/docs/learn/deploy/release-strategy/release-policy/)\nto avoid the device downloading a newer release straight away, if available.\nCheck also the Preloading and Preregistering section of the balena CLI's advanced\nmasterclass document:\nhttps://www.balena.io/docs/learn/more/masterclasses/advanced-cli/#5-preloading-and-preregistering\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\nNote that the this command requires Docker to be installed, as further detailed\nin the balena CLI's installation instructions:\nhttps://github.com/balena-io/balena-cli/blob/master/INSTALL.md\nThe `--dockerHost` and `--dockerPort` flags allow a remote Docker engine to\nbe used, however the image file must be accessible to the remote Docker engine\non the same path given on the command line. This is because Docker's bind mount\nfeature is used to \"share\" the image with a container that performs the preload.",
+      "examples": [
+        "$ balena preload balena.img --fleet MyFleet --commit e1f2592fc6ee949e68756d4f4a48e49bff8d72a0",
+        "$ balena preload balena.img --fleet myorg/myfleet --splash-image image.png",
+        "$ balena preload balena.img"
+      ],
+      "flags": {
+        "fleet": {
+          "char": "f",
+          "description": "fleet name or slug (preferred)",
+          "name": "fleet",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "commit": {
+          "char": "c",
+          "description": "The commit hash of the release to preload. Use \"current\" to specify the current\nrelease (ignored if no appId is given). The current release is usually also the\nlatest, but can be pinned to a specific release. See:\nhttps://www.balena.io/docs/learn/deploy/release-strategy/release-policy/\nhttps://www.balena.io/docs/learn/more/masterclasses/fleet-management/#63-pin-using-the-api\nhttps://github.com/balena-io-examples/staged-releases",
+          "name": "commit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "splash-image": {
+          "char": "s",
+          "description": "path to a png image to replace the splash screen",
+          "name": "splash-image",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dont-check-arch": {
+          "description": "disable architecture compatibility check between image and fleet",
+          "name": "dont-check-arch",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "pin-device-to-release": {
+          "char": "p",
+          "description": "pin the preloaded device to the preloaded release on provision",
+          "name": "pin-device-to-release",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "additional-space": {
+          "description": "expand the image by this amount of bytes instead of automatically estimating the required amount",
+          "name": "additional-space",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "add-certificate": {
+          "description": "Add the given certificate (in PEM format) to /etc/ssl/certs in the preloading container.\nThe file name must end with '.crt' and must not be already contained in the preloader's\n/etc/ssl/certs folder.\nCan be repeated to add multiple certificates.",
+          "name": "add-certificate",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "docker": {
+          "char": "P",
+          "description": "Path to a local docker socket (e.g. /var/run/docker.sock)",
+          "name": "docker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dockerHost": {
+          "char": "h",
+          "description": "Docker daemon hostname or IP address (dev machine or balena device) ",
+          "name": "dockerHost",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dockerPort": {
+          "description": "Docker daemon TCP port number (hint: 2375 for balena devices)",
+          "name": "dockerPort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ca": {
+          "description": "Docker host TLS certificate authority file",
+          "name": "ca",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cert": {
+          "description": "Docker host TLS certificate file",
+          "name": "cert",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "description": "Docker host TLS key file",
+          "name": "key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "preload",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "primary": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "preload",
+        "index.js"
+      ]
+    },
     "push": {
       "aliases": [],
       "args": {
@@ -4074,30 +4074,6 @@
         "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": {
@@ -4313,6 +4289,30 @@
         "upload.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"
+      ]
+    },
     "ssh-key:add": {
       "aliases": [],
       "args": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "balena-cli",
-  "version": "23.2.5-build-update-docker-progress-5-4-0-224a174b777b629fd139c0cd1128c1df40553fb5-1",
+  "version": "23.2.5-build-os-configure-flasher-b7a7baa53519fec52b36c41d9edb9006e27e5a89-3",
   "description": "The official balena Command Line Interface",
   "main": "./build/app.js",
   "homepage": "https://github.com/balena-io/balena-cli",
@@ -186,7 +186,7 @@
     "@oclif/plugin-version": "^2.2.32",
     "@sentry/node": "^10.17.0",
     "balena-config-json": "^4.2.7",
-    "balena-device-init": "^8.1.14",
+    "balena-device-init": "^8.2.0",
     "balena-errors": "^4.7.3",
     "balena-image-fs": "^7.5.2",
     "balena-preload": "^18.0.5",
@@ -203,7 +203,7 @@
     "date-fns": "^4.1.0",
     "denymount": "^2.3.0",
     "docker-modem": "^5.0.6",
-    "docker-progress": "^5.4.0",
+    "docker-progress": "^5.1.3",
     "dockerode": "^4.0.5",
     "ejs": "^3.1.6",
     "etcher-sdk": "^10.0.0",
@@ -262,6 +262,6 @@
     "balena-request": "14.0.6"
   },
   "versionist": {
-    "publishedAt": "2025-12-04T21:39:25.723Z"
+    "publishedAt": "2025-12-04T21:48:38.225Z"
   }
 }