Balena-preload NPM | npm.io

15.0.5 • Published 19 days ago

Install

Weekly downloads

601

License

Apache-2.0

Repository

Last release

19 days ago

balena-preload

Script for preloading balena OS images (.img) with a user application container.

Using this will allow images with supervisor version above 1.0.0 to run the user application without connectivity, and without the need to download the container.

Warning

In order to preload images that use the overlay2 Docker storage driver (like nvidia jetson tx2 for example), you need to load the overlay Linux module:

sudo modprobe overlay

For other images you will need to have the aufs module loaded.

Deprecation

The standalone mode described below (balena-preload) is now deprecated. It will be removed in a future release. You should use balena-cli instead.

Install balena-cli and run balena help preload.

Install via npm

$ npm install --global balena-preload

Requirements

Node
Docker tested on 1.12.6 and up but 17.04 or up is recommended especially on macOS, docker-toolbox is not supported. Older versions of balena-preload do support docker-toolbox, see Version Compatibility below.

Issues

If you encounter any problem, you can open an issue

Known Issues

Speed Issues For Flasher Images on macOS

Docker on macOS has some speed issues with volumes. This makes this script slow, especially with Flasher Images.

Version Compatibility

This version will only work for balena OS versions 1.2 and later. For versions earlier than 1.2 you will need to checkout commit 5d6d4607bffc98acdf649ce5328e2079dfb9c3d9 of this repo and then follow the steps below.

BTRFS Support

Since Docker for Mac removed support for the BTRFS storage driver (see docker/for-mac/issues/388), preloading images prior to balena OS 2.0 will require the older Docker toolbox setup with VirtualBox to function properly.

balena balenaos image docker container

balena-sdk bluebird compare-versions docker-progress dockerode get-port lodash node-cleanup request request-promise tar-fs

balena-cli @everything-registry/sub-chunk-1212 @zalastax/nolb-bal

19 days ago

19 days ago

19 days ago

15.0.4-build-remove-unused-cli-visuals-20bd6818f90141ac80d888a338b6326eea528ec0-1

19 days ago

15.0.5-build-remove-unused-dependencies-429315f21df769a3408610cdcacfa3a02ac3edc1-1

19 days ago

15.0.3-build-etcher-sdk-9-0064ac206ffb8e7db103e11806c4f2ee53b67649-1

20 days ago

3 months ago

15.0.2-build-upgrade-dockerode-502c7309af91bc1190b891c99590913c852d4a04-1

3 months ago

14.0.3-build-fix-preload-with-commit-6c9da970c63b67a8469843c2c4f940dee4f832ec-1

7 months ago

15.0.0-build-drop-node-16-ec2dd2b5be4ff921017e072d65d8aada31fc5caa-1

6 months ago

6 months ago

6 months ago

15.0.1-build-bump-balena-sdk-469e95af6c11541a994cd60ec6189dea30568332-1

6 months ago

14.0.1-build-oj-uses-target-state-api-for-preloading-2e25beb4bc924b4f6c0008bc1f6570e8e07bc41d-1

9 months ago

9 months ago

8 months ago

7 months ago

14.0.2-build-update-balena-sdk-to-18-a3b7e66b350ff65f3a3e42ce7d681f1c454c0c0f-1

8 months ago

11 months ago

14.0.0-build-sdk-v17-95005eaa658370a4627a42b8c627662c7fe42199-1

11 months ago

14.0.0-build-sdk-v17-8da8bd3b5ca975741c502a605d739a5904884dee-1

11 months ago

14.0.0-build-sdk-v17-98a0b5174457239ee2b0b3270d4089ceb5c6878d-1

11 months ago

12.3.0-build-aethernet-dotetchpreload-525cb1280fd419ea31266210b4d5da0965f3253d-1

1 year ago

13.1.0-build-aethernet-dotetchpreload-b1d719a2224ea0b9a78dd1a0e799afd6b3ea23ff-1

1 year ago

13.1.0-build-aethernet-dotetchpreload-ac18fd7ed9c69d2e15e78643969a8dc1a3a36efc-1

1 year ago

12.3.0-build-aethernet-dotetchpreload-f5adaf8baeda760c647638cedccb3331636b31dd-1

1 year ago

13.1.0-build-aethernet-dotetchpreload-637402e77afc2f99a03b6b78759152df47498136-1

1 year ago

12.2.0-build-aethernet-fixstdin-a6329cb3bc04ece7af043ae1f3ffdd5b20bf27a8-1

1 year ago

1 year ago

12.3.0-build-aethernet-node12--ec4b7dd6064d2719d4f1753f5c4ecf57a6c20196-1

1 year ago

13.0.0-build-aethernet-removeEdison-af3652f0d66406fe0d5b399193c33903940f5453-1

1 year ago

13.0.0-build-aethernet-removeEdison-aee1a63f5d586be8c8c46d2b45d3219dfb300a1d-1

1 year ago

13.1.0-build-aethernet-dotetchpreload-f303a01de5c7a848830816feecd6b09e14695d6b-1

1 year ago

1 year ago

13.1.0-build-aethernet-dotetchpreload-f252d5c93d25b29f44cfdd8851d3ad2fa32326b4-1

1 year ago

12.1.1-aethernet-flowzone-4af8c26e83e439a806c22b6676454e7381036896-1

1 year ago

12.1.1-aethernet-flowzone-d2a410a23984098aa667c00475ac608f9ed22cfc-1

1 year ago

12.2.0-aethernet-flowzone-bbaef7575515a36a0d656695e3aa831102820fbc-1

1 year ago

12.2.0-aethernet-flowzone-0d3c6f37e56a0efeaeadb52f2f8ec97e77ea5342-1

1 year ago

1 year ago

12.1.0-preload-v3-82f8f5c87731fe8d1b244ab9d4243426707b7c15

2 years ago

12.1.0-preload-v3-374f65d6c02e8bb68eb740c7b66faf917280a44a

2 years ago

12.0.1-kyle-supervisor-regex-b1e291198125783410581442bc8adf4cee41a73d

2 years ago

12.1.0-preload-v3-e95d054b866ba80c06b04020cae6f9415a956741

2 years ago

12.1.0-preload-v3-b212c5bcb5238989c94331992c9f1b46881c73db

2 years ago

12.1.0-preload-v3-02d2264acd2e5ca01bb907d24426c4a3c919839d

2 years ago

12.1.0-preload-v3-b4896967701d1885b68b88cc6c84259aa832ba41

2 years ago

2 years ago

12.1.0-preload-v3-09949ef88708069a60860bb5baf0d8e61af9e5e9

2 years ago

2 years ago

2 years ago

12.0.0-less-config-json-ee7589dc31bcdc12813128c6875dded3bfa2e506

2 years ago

12.0.0-less-config-json-fdebfb95ef6f7087c22e77ccedeb418de7655e87

2 years ago

11.0.0-fix-incorrect-index-check-6b5b6428833ce2cd5c53c2051d6f515f1b3e4c37

3 years ago

3 years ago

11.0.0-fix-incorrect-index-check-6bb96fc7ddc9d9cac333693f205d2b434b727561

3 years ago

11.0.0-fix-incorrect-index-check-8c586c7d21b8c9c7a10088cfd04f60fcc16df333

3 years ago

11.0.0-fix-incorrect-index-check-9cca456fc0f2664faeae8efe0b40211e8d9d88fb

3 years ago

11.0.0-fix-incorrect-index-check-9a2ebfdb2a5375304ee5cf2ba6321b93f93886ed

3 years ago

11.0.0-fix-incorrect-index-check-7de06434155913b199024683e62c85e94f1d1cb1

3 years ago

11.0.0-fix-incorrect-index-check-aa7a8b9cb006c83367a4c65578759917be99ad79

3 years ago

11.0.0-fix-incorrect-index-check-ce241be0a780bdff87f4513e4d5a0ec63d72ac7e

3 years ago

10.6.0-use-prebuilt-image-fbd2f1c93961fec22442c3ec3a74bc4c5335181d

3 years ago

10.6.0-use-prebuilt-image-dc2493145999eddc16e633392501dbd74bf75fb8

3 years ago

10.4.12-use-prebuilt-image-1cd02a4911c9160e9e600f67335b5ca68f6f1a0a

3 years ago

10.6.0-use-prebuilt-image-b92e1e82f1f8e07ee8f342de07cf64e0549c830e

3 years ago

10.5.1-use-prebuilt-image-5b6edddb408d2929588414a3ac5099dc86a0a485

3 years ago

3 years ago

10.5.0-custom-dind-d32490e6cf192f05992cf65b2549685e4331bed7

3 years ago

10.5.0-custom-dind-da4864336db4c148de725449353329f01d872178

3 years ago

10.5.0-custom-dind-d9be2174e1d7b809f876b89ebbc596c30a277022

3 years ago

10.5.0-custom-dind-dbe041004cb02ead27268aac7706a1ee2835e5e9

3 years ago

10.5.0-custom-dind-ad1b9428c862d43df3d8f8ef3e6d8015435a60ea

3 years ago

10.5.0-custom-dind-dc1dc5ec85a26cbb58108a542836ddff3945d0b0

3 years ago

10.4.12-use-prebuilt-image-92b873087685ed5f75a64202ee83a485299f1e32

3 years ago

10.4.20-klutchell-patch-1-b12e7e745a4f7cb2d1156ddabcd33d39603db523

3 years ago

3 years ago

10.5.0-custom-dind-43a85d626fcdf62dd7dde2c9e4d9590e0f60ea5a

3 years ago

10.4.13-tmp-promise-5d8062f08702795848b881929e11f8fde9dcee36

3 years ago

10.4.17-class-syntax-instance-vars-edadfeac73343faa89d7e5784e4c51fb39162322

3 years ago

10.4.16-catch-build-errors-4828423923e547c58d3c8e811d7d2ddbe258241b

3 years ago

10.4.12-prefer-appid-e9482adef6a685d72b0ac80a1ebe3925ae5f5016

3 years ago

10.5.0-custom-dind-34709516354a37c02937bd3fcc24d15886eaa3b8

3 years ago

10.4.19-earlier-and-parallel-49a25f57a14997f1e343cb866a4f9f7aa04a6734

3 years ago

10.4.13-tmp-promise-6ce04ad80be8cf5f7a6b307750588b85721c2a16

3 years ago

10.4.19-dd-blkid-part-labels-92fb9512c1f8d972c34f122bb9de75dce0816774

3 years ago

10.4.13-remove-unnecessary-vars-69199f2add5106a4b7994479888a352f27970c33

3 years ago

10.4.13-tmp-promise-bae2d6bdfa7ac8fc9ead11ba50dca1e69b53b7e4

3 years ago

10.4.18-fix-missing-await-9d6de7d0ffbca78cfad330a83d346f25eb21a094

3 years ago

10.4.10-248-storage-driver-bcd208af8873895020fe5751e89797984eb455a5

3 years ago

10.4.15-async-await-4da2ce03fb9cab2b16aae37f7e70caeb18d6a450

3 years ago

10.4.18-fix-missing-await-ad4ded6bc4caed97be19a9cff3d02f060029d473

3 years ago

3 years ago

10.4.11-update-deps-d22cd96d850061bcb601535f7b61fb6f32f987af

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

10.4.14-remove-unnecessary-vars-7307dfd111af5a7187017fcfe277e2dbda1d9f7c

3 years ago

3 years ago

10.4.9-alexgg-supervisor-version-7d6f20c6227e29d82a7625e491ae10c343dce765

3 years ago

3 years ago

10.4.8-2045-delay-partitions-cache-fce288a0e8ca5aecc6b13d97cabba2b78db4e318

3 years ago

10.4.8-2045-delay-partitions-cache-78c4530eb967b3441fd25773d97c858dc951aef9

3 years ago

10.4.8-alexgg-supervisor-version-9495442e32172b86b1683dd1b7e687b4466d9538

3 years ago

10.4.8-2262-alexgg-preload-fc0dc06462efc7a2350d0229e4215ed4dd154a65

3 years ago

10.4.8-2262-alexgg-preload-87a71899b3a444ca706c4679c34e2635be5b3a0a

3 years ago

10.4.8-alexgg-supervisor-version-e8b8061e526e87492418e74e9c12f554c2383ead

3 years ago

10.4.8-2262-alexgg-preload-4f6b4d6062f11257d71465bd05e9b90479f7af28

3 years ago

10.4.8-2262-alexgg-preload-e9a611b8f0835d50955abe112ac8410e480aef42

3 years ago

10.4.8-2262-alexgg-preload-715f3e99cd7d752df23cef2df53fc0c6a8a98e42

3 years ago

10.4.8-alexgg-supervisor-version-623f73dc45cdba9b54ccccdaea2e5554b033a58b

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

10.4.4-233-catch-dockerd-137-code-b80177d474480157cebf2cd34c6914f1b10a01c5

3 years ago

10.4.7-236-registry-url-f524aa8da8a68161884e5c24015268b8095ef2ba

3 years ago

10.4.6-docker-bluebird-efb8f4699c8988f5b9c1a4a04b53249837c10aeb

3 years ago

10.4.4-233-json-statusCode-ipc-d3847b288d04adf53a1b3124ae90c4170701f6ed

3 years ago

10.4.7-2262-alexgg-preload-08bff28a8f6e7fb637bf0ba8dfd64ef024fd12f0

3 years ago

10.4.3-docker-bluebird-9cb902c121ef57e3756ab57880ccb08b7f58494c

3 years ago

10.4.8-2262-alexgg-preload-1575c8690626ab9c0fe0753dcd3d1f2d5c160052

3 years ago

10.4.4-233-sh-truncate-exc-c463e38d1a512d25c8245244b59c9f9944e09fc9

3 years ago

10.4.4-233-sh-truncate-exc-aca3ba279aafea4372e040c1f2d26bbda685f988

3 years ago

10.4.2-dind-v20-10-6-7560b572fd0489cf8ec9825ddd3eebc6ab1df26c

3 years ago

10.4.4-233-catch-dockerd-137-code-cce395e588f066c6ef968119be0f39a76005ccb9

3 years ago

10.4.7-236-registry-url-8d73ddcad4a20c11644cb95119d3afca85680696

3 years ago

10.4.7-2262-alexgg-preload-a0908d97e89eb8f29a6fba36eb580aaeed5d6207

3 years ago

10.4.3-docker-bluebird-2ffb62ddd5afd39164df137861ede95f8dfb8e1b

3 years ago

10.4.3-233-sh-truncate-exc-42af35f125713a4d842cd32c1aaae17213e75b75

3 years ago

10.4.8-2262-alexgg-preload-e3a74c6b1afd6a86ba3092a1d164996d5c0a2dbc

3 years ago

10.4.7-2262-alexgg-preload-681e5c7103e86cb4410e1237f9908b00e714385b

3 years ago

10.4.7-236-registry-url-4c70114b69af745fdfe853495d86e1ca3e9ea6c0

3 years ago

10.4.7-236-registry-url-2d29ea0851889ea4c2327307780bc01419dcf65a

3 years ago

10.4.4-233-catch-dockerd-137-code-8f2424d1b455727e95fe02265d50d64f3973e85a

3 years ago

10.4.8-2262-alexgg-preload-57b64ff9cd5687722486510c8a76a30a52aa07bc

3 years ago

10.4.7-236-registry-url-e9ce599116450dcbfda7509d326949a2ba65b1ba

3 years ago

10.4.5-233-json-statusCode-ipc-dbd60732b5eab238475bcb34157856f783678edb

3 years ago

10.4.7-2262-alexgg-preload-8ed207ab1c2257c10e1f678df4893a62f74b28ca

3 years ago

10.4.3-233-dont-truncate-error-logs-fb4dbe26eccae10a555d6f88244f5e940fa9348b

3 years ago

10.4.5-docker-bluebird-33814e910ae67905ae9c5100660d5f1847364dc2

3 years ago

10.4.7-236-registry-url-1619ee30b6644dabcbd2f7f7fb5141dd9fa01cd5

3 years ago

10.4.8-2262-alexgg-preload-8e1ab6d47cb57f389d567b876c121e037f6e466a

3 years ago

10.4.7-236-registry-url-99f16d5c033c2c2e7790bc00670755d27b6f4f03

3 years ago

10.4.7-2262-alexgg-preload-d068f5d8ff6c07c673dee59538978f6433b28646

3 years ago

3 years ago

10.4.1-separate-volume-for-temporary-docker-pull-files-2dc46493b4301e598d3f69d4116ddfa3b73f88f9

3 years ago

4 years ago

10.4.0-better-size-estimation-b43b03760d7d3212f0f312d37909200d63875628

4 years ago

10.3.2-233-sh-truncate-exc-feff27b0a0cd5e8ce93564e8a8a25727bd7acffa

4 years ago

4 years ago

10.3.1-balena-logo-splash-87e71c21a08497d126e3bcdca0aa48a542fe8f83

4 years ago

10.3.1-balena-logo-splash-bc0c7297d3248e5e4613b837ae3d3234f9061525

4 years ago

10.3.1-balena-logo-splash-65a34091a1b284413d9bfdaf9ce254b8afaa8be5

4 years ago

4 years ago

10.3.0-update-docker-progress-eb418f80a68193065f982f93448899cfc4e6a088

4 years ago

10.3.0-update-docker-progress-4893312b7e516bafcd45f719af3578fd9905674a

4 years ago

10.3.0-update-docker-progress-a6aaf1717aed42de850b0de1277c5073d1bdea36

4 years ago

4 years ago

10.2.4-nested-changelogs-d14612c9b81ab0d2b69cb6d8b44b94fc0b90336a

4 years ago

4 years ago

4 years ago

10.2.3-fix-build-dir-paths-fd2b0cd8d6855cd6dfcf496e82153ef8cf269e88

4 years ago

10.2.2-update-balena-sdk-58ab5768af6b2c34c87e221bcc08a1cb3aab3e02

4 years ago

10.2.2-update-balena-sdk-1b6bf2e9d6eefe425280187483a6478f1b464a47

4 years ago

4 years ago

10.2.1-modernize-fc217a3b7de757d51d55aa09445b09e62da1958d

4 years ago

4 years ago

10.2.0-retry-losetup-20d20e2eaf7ba6c8ee6067269eb14b34d4e261cf

4 years ago

10.2.0-retry-losetup-4c9fad0308bf8c8a774c73c9e03eab0086c0d1fd

4 years ago

10.1.1-flake8-d3bdc31ad12ffbe64a4f5d83e432a3381ac501eb

4 years ago

4 years ago

10.2.0-retry-losetup-dde5e39520968464136a88ec2be2860c936946cd

4 years ago

4 years ago

10.1.0-optional-sdk-dependency-injection-8eafdaf6c1b30818fabc0259d1c5585684e60e59

4 years ago

10.1.0-optional-sdk-dependency-injection-e617e3cf5fc4308bb481fd5e0b025c6acaaf2f7c

4 years ago

10.0.1-retry-losetup-bcb331fee64b80da0e419bce9778699a42405ebe

4 years ago

10.0.1-retry-losetup-7b3a204e3fbd02bfa58ced408f860b14e53a69b9

4 years ago

4 years ago

10.0.0-balena-sdk-v14-3a6104887a7058ee5ca72175efd615f73b82e472

4 years ago

9.0.0-9-x-2e2b81d70aec051a4f099a7f8f033caeae7e71d9

4 years ago

4 years ago

4 years ago

8.4.0-update-deps-9888515499d41ce15a8bf592e9b9a4abf1ba4789

4 years ago

4 years ago

8.3.1-1588-preload-compatible-architectures-fe900f829dd6c09a458dc69f3be8a6c888632b52

4 years ago

8.4.0-1588-preload-compatible-architectures-eaf3ccc655a320fb546c2a31bf1e1a68fe35bf67

4 years ago

4 years ago

8.3.0-update-deps-5ec6f38d53f038eb0dcdfe7874859eb841437856

4 years ago

4 years ago

8.2.2-upgrade-docker-b94b57ce9a4ae6fb2cb3f399a5f942603fddc069

4 years ago

8.2.2-upgrade-docker-a9885566ec5d2f6ac5eae31c3aa87e412009bcf0

4 years ago

8.2.2-upgrade-docker-9548c0ae52697f98bf0be784cd712f4a00d6a1d1

4 years ago

8.2.2-upgrade-docker-b573aeb78ba9e52572eda02f74b3a364178a2763

4 years ago

8.2.2-upgrade-docker-4e837af30d8a3172b98046d2cc8bf57adec450b4

4 years ago

5 years ago

8.2.1-fix-certificates-path-4e0e295a80c7ac5d41a434d9817684c35adedd37

5 years ago

5 years ago

8.2.0-copy-certificates-option-cb9c8893272929d3f881cfeb4f43506eb836d5f3

5 years ago

8.2.0-copy-certificates-option-01265e3dc85f3a102a230783ba3bc4a7813da857

5 years ago

5 years ago

8.1.4-fetch-latest-commit-7aa76b9733e135b1ff3e6818a4dea8203e5ac77c

5 years ago

5 years ago

8.1.3-regex-f77a0a92720f78827f8774d16cb7a0752e9d595f

5 years ago

8.1.3-regex-7a77f2c250962b56aab1e6f7664485fc8d56f4c9

5 years ago

8.1.3-logstream-653faef390a70c13929f6347531703c1ed8c6ecb

5 years ago

5 years ago

8.1.2-commit-filter-fbe363f3ffe8d6a43fe5834c25405bfafd21ceae

5 years ago

5 years ago

8.1.1-no-name-in-apps-json-c73967e1e31e278471f833cf1ce75a2a8d4d81d1

5 years ago

5 years ago

8.1.0-use-hosts-certificates-0675bf7261efb711c8c53f8d34e817d8dffffb3f

5 years ago

5 years ago

8.0.4-fix-arch-check-4c88b411e4cbf8b7c31a6c2804cb10f850ad4af1

5 years ago

5 years ago

8.0.3-resin-logo-e0f0388b57277d1e9e93ec95bf04b3862a36c211

5 years ago

5 years ago

8.0.2-dont-pin-on-old-supervisors-2eac133c9dcbfe3449b02940523139bcfa779fb0

5 years ago

8.0.2-dont-pin-on-old-supervisors-a4382476f36ec6521002dfe2691b8e39e0c588a1

5 years ago

8.0.2-dont-pin-on-old-supervisors-a2f40928c26599bd23157d15b3e015707790b1cf

5 years ago

5 years ago

8.0.1-fix-loop-devices-not-appearing-in-container-694f4a6eb50d62c45663426e771b6619429ccaa0

5 years ago

6 years ago

8.0.0-rename-db3d8a4e6fb02de3414e1674f179e4a2a7d83ebd

6 years ago

8.0.0-rename-46710fc4e3c692035b1d1a6c7b4be9b413a36905

6 years ago

8.0.0-rename-fba862b6fb1909e125d076b871cadf232bdbbd7d

6 years ago

8.0.0-rename-897d49e2b8da9f944ed31dda74d97f4df08cff3f

6 years ago

8.0.0-rename-4d98fcf0e8aa10b502eb8c6a56ef34fa804ec0ce

6 years ago

7.0.6-rename-bcbbf7e680435b8a8a543bc7cec6b4c9a82db33b

6 years ago

7.0.6-rename-e4cdba9aa01fe94fc0c9326825f7afe42ce2e81c

6 years ago

7.0.6-rename-2ebb48864df9bce35c35c2b4756175645ce62ae6

6 years ago