NAME¶

arduino-cli-upload - Upload Arduino sketches.

SYNOPSIS¶

arduino-cli upload [flags]

DESCRIPTION¶

Upload Arduino sketches. This does NOT compile the sketch prior to upload.

OPTIONS¶

--board-options=[] List of board options separated by commas. Or can be used multiple times for multiple options.

--build-path="" Directory containing binaries to upload.

--discovery-timeout=1s Max time to wait for port discovery, e.g.: 30s, 1m

-b, --fqbn="" Fully Qualified Board Name, e.g.: arduino:avr:uno

-h, --help[=false] help for upload

--input-dir="" Directory containing binaries to upload.

-i, --input-file="" Binary file to upload.

-p, --port="" Upload port address, e.g.: COM3 or /dev/ttyACM2

-m, --profile="" Sketch profile to use

-P, --programmer="" Programmer to use, e.g: atmel_ice

-l, --protocol="" Upload port protocol, e.g: serial

-F, --upload-field= Set a value for a field required to upload.

--upload-property=[] Override an upload property with a custom value. Can be used multiple times for multiple properties.

-v, --verbose[=false] Optional, turns on verbose mode.

-t, --verify[=false] Verify uploaded binary after the upload.

OPTIONS INHERITED FROM PARENT COMMANDS¶

--additional-urls=[] Comma-separated list of additional URLs for the Boards Manager.

--config-dir="" Sets the default data directory (Arduino CLI will look for configuration file in this directory).

--config-file="" The custom config file (if not specified the default will be used).

--json[=false] Print the output in JSON format.

--log[=false] Print the logs on the standard output.

--log-file="" Path to the file where logs will be written.

--log-format="text" The output format for the logs, can be: text, json

--log-level="info" Messages with this level and above will be logged. Valid levels are: trace, debug, info, warn, error, fatal, panic

--no-color[=false] Disable colored output.

EXAMPLE¶

  debian/build/bin/arduino-cli upload /home/user/Arduino/MySketch -p /dev/ttyACM0 -b arduino:avr:uno


  debian/build/bin/arduino-cli upload -p 192.168.10.1 -b arduino:avr:uno --upload-field password=abc

SEE ALSO¶

arduino-cli(1)

HISTORY¶

15-Aug-2026 Auto generated by spf13/cobra