Skip to content
Eric Busboom edited this page Aug 31, 2026 · 6 revisions

MB Deploy

Build micro:bit firmware and flash it to one board or a whole fleet, over USB or across the LAN.

  • Command reference — Every subcommand and flag, the exit-code contract, and the stdout/stderr split.
  • Deploying the daemon — Installing mbdeploy serve as a systemd service on a node with boards attached — and where the actual machines are documented.
  • The device model — Two chips and two identities, what the registry stores, and how a target string is resolved.
  • Building and flashing — What deploy actually runs, how a locked nRF is recovered automatically, and why pyOCD's output is streamed.
  • The fleet daemon — serve, its two mDNS services, both wire protocols verbatim, and the exclusivity rules between them.
  • Overview and installation — What mbdeploy solves, what it depends on, and how to install it on macOS and Linux.
  • The remote client — --remote on list, connect, and deploy — how a board is found on the LAN, and which flags stop meaning anything.
  • Start here — What mbdeploy is, where the machines are documented, and what is still missing.
  • Troubleshooting — The failures that look like bugs and are not, and the ones that are.

🔒 Internal: Machine names, IPs, credentials → mbdeploy private

Clone this wiki locally