Installing Particle CLI
The CLI uses Node.js and can easily run on Windows, Mac OS (OS X), and Linux.
- Windows
- Mac OS or Linux
Download the Windows CLI Installer and run it to install the Particle CLI. The Windows CLI installer is self-contained and can be run on a computer without Internet access, however CLI commands that interact with the Particle cloud will of course need Internet access.
The CLI is installed to %LOCALAPPDATA%\particle
For example:
C:\Users\username\AppData\Local\particle (for Windows in English)
The easiest way to install the CLI is to open a Terminal and type:
bash <( curl -sL https://particle.io/install-cli )
This command downloads the particle command to your home directory at ~/bin.
Verify Installation
Confirm the CLI is installed:
particle --version
3.38.1
Upgrading to the latest version
If you installed the Particle CLI through the installer, it will periodically update itself to the latest version.
To force it to update, run the installer script again or enter this command:
$ particle update-cli
Disabling automatic updates
If you wish to prevent automatic updates from occurring you can do so with the following command. This might be appropriate on an assembly line where you want to keep the configuration and binaries constant, however in general we recommend always using the current version.
$ particle update-cli --disable-updates
Reenabling automatic updates
To resume updates and update if necessary now:
$ particle update-cli --enable-updates
Installing a specific version
$ particle update-cli --version <version>
can be any version 3.23.0 or later. This also disables automatic updates.
For more information about installing a specific version, see specific CLI version.