All apps/balena CLI

balena CLI

balena-cli

The official balena CLI tool.

Runs as balena|macOS, Linux, Windows|github.com

Command form

ai-draft · 2 tasks · 10 fields

Push a project to balenaCloud or a local mode device. Other balena commands and login are left out.

Opens the form; the finished command lands at your prompt, unrun
otty gui balena-cli

balena push

Push a project

Build release images on balenaCloud or on a local mode device from a source directory.

Push a projectExample values, fixed in this page — nothing here reaches a terminal
Basic
Fleet or device*
string
Source directory
directory
TasksEach one presets the form for one job
Push current project
targetsource
Push and return immediately
targetsourcedetached
ParametersOnly these flags are editable in the form
Fleet or device
Fleet name or slug, or local device IP address or .local hostname.
string · positional 0
Source directory
Defaults to the current directory.
path
--source-s
Dockerfile
Alternative Dockerfile name or path, relative to the source folder.
string
--dockerfile
No cache
boolean
--nocache-c
Force QEMU emulation
boolean
--emulated-e
Pull base images again
Local device only.
boolean
--pull
Detached
boolean
--detached-d
No live session
boolean
--nolive
Registry secrets file
path
--registry-secrets-R
Only logs from service
Local mode device only.
string · repeatable
--service
SourcesEvery flag above is checked against these
docs
#### FLEETORDEVICE fleet name or slug, or local device IP address or ".local" hostname #### -s, --source SOURCE Source directory to be sent to balenaCloud or balenaOS device (default: current working dir) #### -e, --emulated Don't use the faster, native balenaCloud ARM builders; force slower QEMU ARM emulation on Intel x86-64 builders. #### --dockerfile DOCK…
manualHEAD 2026-10-27

raw.githubusercontent.com

docs
#### FLEETORDEVICE fleet name or slug, or local device IP address or ".local" hostname #### -s, --source SOURCE Source directory to be sent to balenaCloud or balenaOS device (default: current working dir) #### -e, --emulated Don't use the faster, native balenaCloud ARM builders; force slower QEMU ARM emulation on Intel x86-64 builders. #### --dockerfile DOCK…
manualHEAD 2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed balena against its version. A form that does not match your version is not offered.