Using a specific Particle CLI version

The Particle CLI should generally be installed using the instructions here, however there are some special cases where you may want to run an older version of the Particle CLI:

  • The particle update command in the CLI installs the specific LTS version of Device OS that the CLI was built to install, not necessarily the most recent version. If you want to install a specific older version of Device OS, you may want to use an older version of the CLI to do so.

  • Support for discontinued platforms like the Spark Core no longer exists in the current version of the CLI, so you may want to use an older version of the CLI to do things like flash the cc3000 update.


The recommended path is to install the CLI as above first. Alternatively, if you've installed Particle Workbench, it will install the Particle CLI as well. This is necessary because there are other required dependencies like dfu-util that are installed by the CLI installer that are difficult to install manually.

The current source for the Particle CLI can be found in Github and the release notes can be found here. The release notes can help you determine which version of the CLI you need.

Some versions of interest:

  • CLI v3.5.0 switched to Device OS 4.0.0 LTS.
  • If you need to use Device OS 2.3.0 LTS, you can use CLI v3.2.0.
  • If you need to use older platforms such as Redbear Duo and Core, use v2 (v2.16.0, currently).
  • The release notes indicate which Device OS version is installed by that version of the CLI if you want to install a specific version
  • There is no way to install the developer preview releases of Device OS (3.x, 5.x) using particle update.

To replace the existing particle command you can use:

npm install -g particle-cli@3.2.0

Or, for the latest CLI 2.x version (currently 2.16.0):

npm install -g particle-cli@2

To restore the current version of the Particle CLI you can use:

particle --update-cli