ARDUINO-CLI-UPLOAD(1)

📦
version 1.5.1 · 2 versions
, in ubuntu stonking

🎀 ARDUINO-CLI-UPLOAD 💅

okay bestie, welcome to the arduino-cli upload page from the ARDUINO COMMAND LINE MANUAL, section 1 ✨ buckle up, this one gets your sketch onto the board, no cap.

✨ NAME ✨

arduino-cli-upload — get your Arduino sketch onto the board. Uploading. Slay. 💖

🦋 SYNOPSIS 🦋

arduino-cli upload [flags]

🌸 DESCRIPTION 🌸

So like, this command uploads your Arduino sketch. That's the whole vibe. 🫶

BUT — and this is the important part, bestie, don't skip it — this does NOT compile the sketch before uploading. It does not. Zero compiling. None. So if you haven't already built it, that's a you problem, and you need to go do that first. The upload command is just the last little hop. ✈️

💅 OPTIONS 💅

  • --board-options=[] — a list of board options, separated by commas. Or you can use it multiple times if you've got multiple options to set. Your call, girlie 🎀
  • --build-path="" — the directory holding the binaries you wanna upload.
  • --discovery-timeout=1s — the max time to wait around for port discovery. like 30s, 1m, that kind of thing. don't leave it waiting forever, the port will show up when it shows up 🙈
  • -b, --fqbn="" — the Fully Qualified Board Name. e.g. arduino:avr:uno. this is your board's whole government name, you gotta know it.
  • -h, --help[=false] — help for upload. the classic. 🤝
  • --input-dir="" — the directory holding binaries to upload.
  • -i, --input-file="" — the binary file to upload.
  • -p, --port="" — the upload port address, e.g. COM3 or /dev/ttyACM2. this is your board's address, where it lives.
  • -m, --profile="" — the sketch profile to use.
  • -P, --programmer="" — the programmer to use, e.g: atmel_ice.
  • -l, --protocol="" — the upload port protocol, e.g: serial.
  • -F, --upload-field= — set a value for a field that's required to upload. giving it exactly what it needs bestie 💅
  • --upload-property=[] — override an upload property with a custom value. can be used multiple times for multiple properties. lowkey the power move ✨
  • -v, --verbose[=false] — optional! turns on verbose mode. if it's broken and you're nosey, this is your moment 👀
  • -t, --verify[=false] — verify the uploaded binary after the upload. double-checking is so valid.

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

these are the ones you got from the parent command, like inherited family drama but useful 🌈

  • --additional-urls=[] — a comma-separated list of additional URLs for the Boards Manager.
  • --config-dir="" — sets the default data directory (Arduino CLI will look for the configuration file in this directory).
  • --config-file="" — the custom config file (if it's not specified, the default one gets 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 the 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. (me ?? giving up color ?? tragic but okay 😭)

🔥 EXAMPLE 🔥

here's how the girlies actually run it, no cap:

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? board, port, fqbn. the holy trinity 🫶

💜 SEE ALSO 💜

⭐ HISTORY ⭐

  • 15-Aug-2026 — Auto generated by spf13/cobra.
lowkey reminder: this page is auto generated by spf13/cobra, so don't come for me about the wording. the facts are the facts, bestie 💀

and that's the whole page, fr fr! 💖 this came from the ARDUINO COMMAND LINE MANUAL, section 1, dated Aug 2026, and yes it was Auto generated by spf13/cobra — so go forth, upload your sketch, and be the main character of your own serial port ✨👑🦋 periodt 🎀

📦 where this page comes from