← Package directory
Available on winget

Install balena-cli

The balena CLI is a Command Line Interface for balenaCloud or openBalena.

Install with winget
winget install --id Balena.BalenaCLI
Upgrade
winget upgrade --id Balena.BalenaCLI
Uninstall
winget uninstall --id Balena.BalenaCLI

About balena-cli

The balena CLI is a Command Line Interface for balenaCloud or openBalena. It is a software tool available for Windows, macOS and Linux, used through a command prompt / terminal window. It can be used interactively or invoked in scripts. The balena CLI builds on the balena API and the balena SDK, and can also be directly imported in Node.js applications. The balena CLI is an open-source project on GitHub, and your contribution is also welcome!

What's new in 25.1.6

562b1e4 (Fix link in help output about FAQ and troubleshooting, 2026-05-13) 2b62874 (Deduplicate dependencies, 2026-05-15)

Read release notes

Version history

Version Updated Notes
25.1.6 Unknown 562b1e4 (Fix link in help output about FAQ and troubleshooting, 2026-05-13) 2b62874 (Deduplicate dependencies, 2026-05-15)
25.1.5 Unknown fb681df (Update GitHub Actions, 2026-05-13)
25.1.3 Unknown 817d158 (Bump @balena/compose-parser to 0.2.1, @balena/compose to 8.0.2, 2026-05-01)
25.1.1 Unknown c5988e1 (tests: Update builder dashboard link, 2026-04-30) 7105369 (Deduplicate dependencies, 2026-04-30)
25.1.0 Unknown 039eef8 (Add organization management commands, 2026-04-24)
25.0.0 Unknown Update @balena/compose to v8 This release adds CLI support for a number of compose fields in the latest docker compose spec. The fields are listed below, however note that balena Supervisor support needs to be added for...
24.1.4 Unknown 6251f3c (Retry ratelimited requests that have a Retry-After less than 60 seconds, 2026-04-24) 2c343d0 (Deduplicate dependencies, 2026-04-27)
24.1.3 Unknown a97edb0 (test(device ssh): unset proxy env vars that break stderr assertions, 2026-04-07)
24.1.2 Unknown d0e19ed (Update @balena/lint to prepare for TS6.0, 2026-04-07) 657f56c (Deduplicate dependencies, 2026-04-07) 12a64e3 (Unblock color tests on CI after deduplicating supports-color, 2026-04-07)
24.0.3 Unknown 3420382 (Deduplicate dependencies, 2026-02-26) cb22fb0 (Disable background auto-updates, 2026-02-26)
24.0.2 Unknown 508a595 (Deduplicate dependencies, 2026-02-18) d184e5e (Update balena-sdk to 23.0.2, 2026-02-18)
23.2.32 Unknown cc32211 (tests: Replace the deprecated url.parse with new URL(), 2026-02-11) f8702f5 (Remove unnecessary 'url' imports, 2026-02-11) 84edd27 (tests/build: Increase the test timeout to 1.5 minute, 2026-02-11)
23.2.22 Unknown 2697746 (Remove unused setMaxListeners function, 2026-01-13) 9f72030 (Reduce overall usage of require, 2026-01-13)
23.2.21 Unknown 0a43fa0 (Update balena-image-fs to 7.6.0, 2026-01-13) 2216598 (Remove no longer needed code in favor of balena-image-fs, 2026-01-13) 7c978a0 (Remove no longer needed direct dependencies file-disk and partitioninfo, 2026-...
23.2.19 Unknown d3392a9 (README: remove david-dm link, 2026-01-12) 156af67 (Remove unused dev dependencies, 2026-01-12) 6c90666 (Add missing dependency indent-string, 2026-01-12) 7eb41c3 (Add missing dev dependency pinejs-client-core, 2...
23.2.18 Unknown 09cea86 (Deduplicate dependencies, 2026-01-13) 2eaa5c1 (Add tests for balena config generate, 2026-01-13)
23.2.17 Unknown 23c645a (os download: Correct img names to match devices type in examples, 2026-01-01) 59b639d (Update reconfix to 1.0.2, 2026-01-12) 15bf2d6 (Update balena-device-init to 8.2.1, 2026-01-12) d8f50d0 (Drop exit-hook patch...
23.2.16 Unknown ff73fed (tests: Replace nock, mock-require and rewire with mockttp and sinon, 2025-10-17) 81e6537 (Unpin balena-request from v14.0.6, 2026-01-09)
23.2.15 Unknown d0b98ad (Fix intermitent test on image-manager, 2026-01-09)
23.2.14 Unknown 9ebf244 (Update balena-sdk to 22.4.5, 2025-12-30) df95136 (Use the device.is_connected_to_vpn field for device actions, ssh & tunnel checks, 2025-11-13)