# CLI

**URL:** https://community.particle.io/c/dt/cli/52.md

[Latest](https://community.particle.io/latest.md) · [Categories](https://community.particle.io/categories.md) · [Tags](https://community.particle.io/tags.md)

---

## [How to manually reset your CLI installation](https://community.particle.io/t/how-to-manually-reset-your-cli-installation/54018)

<div class="topic-metadata">

**Author:** [@m\_m](https://community.particle.io/u/m_m)\
**Replies:** 0\
**Last updated:** [January 2, 2020, 5:27pm UTC](https://community.particle.io/t/how-to-manually-reset-your-cli-installation/54018 "2020-01-02T17:27:53Z")

</div>

hi there :wave: if you installed your CLI using our installer / install script (described here) or use Workbench, read on occasionally, the CLI will get itself into a bad state and the only fix is to reinstall it. here…

---

## [How to report bugs & provide feedback](https://community.particle.io/t/how-to-report-bugs-provide-feedback/53835)

<div class="topic-metadata">

**Author:** [@m\_m](https://community.particle.io/u/m_m)\
**Replies:** 0\
**Last updated:** [December 18, 2019, 5:12pm UTC](https://community.particle.io/t/how-to-report-bugs-provide-feedback/53835 "2019-12-18T17:12:57Z")

</div>

Hello Particle CLI users :wave: We greatly value your feedback. To help diagnose and fix your issue as quickly as possible, here’s what you can do: Search in the community for similar reports - often times your quest…

---

## [About the CLI category](https://community.particle.io/t/about-the-cli-category/53717)

<div class="topic-metadata">

**Author:** [@Joe](https://community.particle.io/u/Joe)\
**Replies:** 0

</div>

For discussion about Particle’s CLI.

---

## [Particle flash --local not updating Device OS as expected](https://community.particle.io/t/particle-flash-local-not-updating-device-os-as-expected/71218)

<div class="topic-metadata">

**Author:** [@jettonj](https://community.particle.io/u/jettonj)\
**Replies:** 4\
**Last updated:** [April 10, 2026, 3:01pm UTC](https://community.particle.io/t/particle-flash-local-not-updating-device-os-as-expected/71218 "2026-04-10T15:01:27Z")

</div>

Hi, I've written a simple flashing script that calls, particle flash --local "path/to/firmware.zip" -v on a new Photon 2. The Photon 2 shipped with 5.6.0, but my binaries were compiled with 6.3.3. The CLI mentions th…

---

## [Is it possible to change the server IP on a Photon 2?](https://community.particle.io/t/is-it-possible-to-change-the-server-ip-on-a-photon-2/71102)

<div class="topic-metadata">

**Author:** [@mrferrar](https://community.particle.io/u/mrferrar)\
**Replies:** 4\
**Last updated:** [February 26, 2026, 11:56pm UTC](https://community.particle.io/t/is-it-possible-to-change-the-server-ip-on-a-photon-2/71102 "2026-02-26T23:56:47Z")

</div>

I have several photon 1s connected to a local cloud (using the Brewskey fork), and am hoping to do the same with some Photon 2s. I am working on modifying the server to get a UDP port open, but the first challenge I am r…

---

## [Publish source for particle modified qdl](https://community.particle.io/t/publish-source-for-particle-modified-qdl/71009)

<div class="topic-metadata">

**Author:** [@minionflo](https://community.particle.io/u/minionflo)\
**Replies:** 0\
**Last updated:** [February 11, 2026, 8:00pm UTC](https://community.particle.io/t/publish-source-for-particle-modified-qdl/71009 "2026-02-11T20:00:21Z")

</div>

Hello, would it be possible to publish the source code used to compile the binaries in assets/qdl/?

---

## [Particle Core stuck at blinking blue](https://community.particle.io/t/particle-core-stuck-at-blinking-blue/70752)

<div class="topic-metadata">

**Author:** [@rlogiacco](https://community.particle.io/u/rlogiacco)\
**Replies:** 5\
**Last updated:** [November 17, 2025, 12:59pm UTC](https://community.particle.io/t/particle-core-stuck-at-blinking-blue/70752 "2025-11-17T12:59:26Z")

</div>

Hi, my Spark Core (yeah, it was Spark back then) is stuck at blinking blue (waiting for WiFi) but it’s not projecting any WiFi, not even after firmware reset. I wanted to try a CLI connection, but I’m having huge diffic…

---

## [CLI just hangs after install](https://community.particle.io/t/cli-just-hangs-after-install/70570)

<div class="topic-metadata">

**Author:** [@kayolord](https://community.particle.io/u/kayolord)\
**Replies:** 8\
**Last updated:** [October 10, 2025, 7:59pm UTC](https://community.particle.io/t/cli-just-hangs-after-install/70570 "2025-10-10T19:59:42Z")

</div>

I just installed the CLI using bash \<( curl -sL https://particle.io/install-cli ) and it won’t let me do anything. Just hangs, even trying to print the version doesn’t work. Max OS 14.7.2 (23H311) ➜ ~ bash \<( curl -…

---

## [Tachyons can't Connect for Setup](https://community.particle.io/t/tachyons-cant-connect-for-setup/70537)

<div class="topic-metadata">

**Author:** [@kfessey](https://community.particle.io/u/kfessey)\
**Replies:** 0\
**Last updated:** [October 1, 2025, 4:03am UTC](https://community.particle.io/t/tachyons-cant-connect-for-setup/70537 "2025-10-01T04:03:28Z")

</div>

Hi there :wave: Welcome to the Particle CLI category. If you are reporting a bug or seeking technical help, please include the troubleshooting info listed here in your post AFTER REMOVING THIS MESSAGE :heart:…

---

## [\[Issue\] particle app push unavailable](https://community.particle.io/t/issue-particle-app-push-unavailable/70267)

<div class="topic-metadata">

**Author:** [@rgr](https://community.particle.io/u/rgr)\
**Replies:** 4\
**Last updated:** [August 23, 2025, 9:00pm UTC](https://community.particle.io/t/issue-particle-app-push-unavailable/70267 "2025-08-23T21:00:25Z")

</div>

Hi, I’ve installed CLI but have been unable to use the particle app command. I receive the following error: We're performing maintenance on this command. It will be available again shortly. I’ve received the same error …

---

## [Particle CLI Setup Failed on Ventura macOS](https://community.particle.io/t/particle-cli-setup-failed-on-ventura-macos/69987)

<div class="topic-metadata">

**Author:** [@Kahntagious](https://community.particle.io/u/Kahntagious)\
**Replies:** 3\
**Last updated:** [August 2, 2025, 6:59pm UTC](https://community.particle.io/t/particle-cli-setup-failed-on-ventura-macos/69987 "2025-08-02T18:59:23Z")

</div>

Pardon the newbie here, but I find myself stymied at step one. Attempting to install/setup Particle CLI for the first time on iMac running macOS Ventura 13.7.6. When running the suggested Terminal command: bash \<( cur…

---

## [\[ISSUE\] Monitor One Custom Firmware OTA not changing](https://community.particle.io/t/issue-monitor-one-custom-firmware-ota-not-changing/68946)

<div class="topic-metadata">

**Author:** [@andrewkurzweil](https://community.particle.io/u/andrewkurzweil)\
**Replies:** 4\
**Last updated:** [January 8, 2025, 9:04pm UTC](https://community.particle.io/t/issue-monitor-one-custom-firmware-ota-not-changing/68946 "2025-01-08T21:04:32Z")

</div>

Hi all, happy new year! We write a custom app for Monitor One. It has a PRODUCT\_VERSION(...) definition in main.cpp (right after PRODUCT\_ID(...)). The app compiles locally using workbench (toolchain v1.16.0, device OS v…

---

## [Local build using gcc-arm](https://community.particle.io/t/local-build-using-gcc-arm/67663)

<div class="topic-metadata">

**Author:** [@andrewkurzweil](https://community.particle.io/u/andrewkurzweil)\
**Replies:** 7\
**Last updated:** [September 27, 2024, 8:23am UTC](https://community.particle.io/t/local-build-using-gcc-arm/67663 "2024-09-27T08:23:25Z")

</div>

Curious what everyone is doing to compile extended layout projects in CI/CD pipelines these days. Does the guidance here still apply to device-os v6.x+? Any reason the toolchain isn't included in the particle cli so loc…

---

## [Issues after CLI Tool update](https://community.particle.io/t/issues-after-cli-tool-update/66965)

<div class="topic-metadata">

**Author:** [@StngBo](https://community.particle.io/u/StngBo)\
**Replies:** 13\
**Last updated:** [June 4, 2024, 6:20pm UTC](https://community.particle.io/t/issues-after-cli-tool-update/66965 "2024-06-04T18:20:10Z")

</div>

Hi, I recently updated my cli tool and now some of my automated onboarding scripts have broken. After updating the CLI tool, when I try to call the particle identify command i get the below error: Could not get device …

---

## [Particle CLI not seeing devices on USB (ubuntu and macos)](https://community.particle.io/t/particle-cli-not-seeing-devices-on-usb-ubuntu-and-macos/66823)

<div class="topic-metadata">

**Author:** [@optigan](https://community.particle.io/u/optigan)\
**Replies:** 2\
**Last updated:** [April 30, 2024, 7:19pm UTC](https://community.particle.io/t/particle-cli-not-seeing-devices-on-usb-ubuntu-and-macos/66823 "2024-04-30T19:19:18Z")

</div>

Wanted to update wifi credentials on some old Photon and Argon devices, and so I thought I'd use my trusty particle CLI with particle serial wifi to update those settings. However, when I plugged my device into my old M…

---

## [Cli credentials --file option change in behaviour](https://community.particle.io/t/cli-credentials-file-option-change-in-behaviour/66599)

<div class="topic-metadata">

**Author:** [@GJMorrison](https://community.particle.io/u/GJMorrison)\
**Replies:** 4\
**Last updated:** [March 26, 2024, 5:22pm UTC](https://community.particle.io/t/cli-credentials-file-option-change-in-behaviour/66599 "2024-03-26T17:22:28Z")

</div>

Hi there :wave: We had been using the v3.18.1 version of the cli for our production programming of Argon devices. During this we load several sets of WiFi credentials on using the particle serial wifi --file credentials…

---

## [Batch File For SIM Activation, Product Registration and Flashing](https://community.particle.io/t/batch-file-for-sim-activation-product-registration-and-flashing/66545)

<div class="topic-metadata">

**Author:** [@StngBo](https://community.particle.io/u/StngBo)\
**Replies:** 3\
**Last updated:** [March 14, 2024, 4:43pm UTC](https://community.particle.io/t/batch-file-for-sim-activation-product-registration-and-flashing/66545 "2024-03-14T16:43:24Z")

</div>

Hi All, I am creating a batch file to complete the following steps: Put device connected via USB into listening mode. (I believe this is necessary to call particle identify) Call particle identify and store device var…

---

## [Prompts are not allowed in non-interactive mode](https://community.particle.io/t/prompts-are-not-allowed-in-non-interactive-mode/66437)

<div class="topic-metadata">

**Author:** [@Rashap](https://community.particle.io/u/Rashap)\
**Replies:** 3\
**Last updated:** [March 5, 2024, 4:10pm UTC](https://community.particle.io/t/prompts-are-not-allowed-in-non-interactive-mode/66437 "2024-03-05T16:10:07Z")

</div>

In my Internet of Things class, we recently started seeing an issue with particle serial wifi It seems to only be on Windows machines. NOTE: The below is all down on a Photon 2 running Device OS 5.7.0 in Listening Mode…

---

## [Particle Cli disable automatic update](https://community.particle.io/t/particle-cli-disable-automatic-update/66387)

<div class="topic-metadata">

**Author:** [@harira](https://community.particle.io/u/harira)\
**Replies:** 3\
**Last updated:** [February 21, 2024, 8:52am UTC](https://community.particle.io/t/particle-cli-disable-automatic-update/66387 "2024-02-21T08:52:27Z")

</div>

We have several windows PCs in our production line, that are using particle-cli to program and register particle devices via API. Everytime, if there is an update for CLI, it tries to update itself by installation or mo…

---

## [\[SOLVED\] particle update fails to update Argon over USB](https://community.particle.io/t/solved-particle-update-fails-to-update-argon-over-usb/65700)

<div class="topic-metadata">

**Author:** [@jaza\_tom](https://community.particle.io/u/jaza_tom)\
**Replies:** 1\
**Last updated:** [November 1, 2023, 7:36pm UTC](https://community.particle.io/t/solved-particle-update-fails-to-update-argon-over-usb/65700 "2023-11-01T19:36:49Z")

</div>

Hey, I was having problems updating my Argon via particle CLI today, and the troubleshooting steps in the template helped me solve my problem, so I thought I'd share the details of what fixed things for me in case anyone…

---

## [\[ISSUE\] Repeated self-destruct of particle CLI installation](https://community.particle.io/t/issue-repeated-self-destruct-of-particle-cli-installation/65346)

<div class="topic-metadata">

**Author:** [@DKWood](https://community.particle.io/u/DKWood)\
**Replies:** 9\
**Last updated:** [October 23, 2023, 6:22pm UTC](https://community.particle.io/t/issue-repeated-self-destruct-of-particle-cli-installation/65346 "2023-10-23T18:22:58Z")

</div>

Hey Team, I'm running the Particle Workbench through VSCode under Win10 Pro, and have been having a recurring issue about once every couple of months with the Particle CLI. Basically everything will be working as normal…

---

## [The Doctor didn't complete successfully. Unknown module type: 3](https://community.particle.io/t/the-doctor-didnt-complete-successfully-unknown-module-type-3/65646)

<div class="topic-metadata">

**Author:** [@daneboomer](https://community.particle.io/u/daneboomer)\
**Replies:** 3\
**Last updated:** [October 20, 2023, 12:14pm UTC](https://community.particle.io/t/the-doctor-didnt-complete-successfully-unknown-module-type-3/65646 "2023-10-20T12:14:38Z")

</div>

New error: The Doctor didn't complete successfully. Unknown module type: 3 When trying to run Particle Doctor on a Particle Core. Is this because the CLI updated itself to the latest version ? I didn't get a choice ab…

---

## [CLI error strikes again](https://community.particle.io/t/cli-error-strikes-again/56896)

<div class="topic-metadata">

**Author:** [@daneboomer](https://community.particle.io/u/daneboomer)\
**Replies:** 13\
**Last updated:** [September 27, 2023, 8:16am UTC](https://community.particle.io/t/cli-error-strikes-again/56896 "2023-09-27T08:16:56Z")

</div>

I’ll have a google and see if I can sort this! :wink:

---

## [Query Device OS Version over USB/Serial](https://community.particle.io/t/query-device-os-version-over-usb-serial/65378)

<div class="topic-metadata">

**Author:** [@radek](https://community.particle.io/u/radek)\
**Replies:** 1\
**Last updated:** [September 8, 2023, 4:44pm UTC](https://community.particle.io/t/query-device-os-version-over-usb-serial/65378 "2023-09-08T16:44:42Z")

</div>

Is it possible to identify the device os version via the particle cli using a usb connection? For instance, if I have a b402 running 4.1.0, is it possible to retrieve this information? I would like to do this without in…

---

## [Particle CLI build: set PRODUCT\_VERSION()?](https://community.particle.io/t/particle-cli-build-set-product-version/65367)

<div class="topic-metadata">

**Author:** [@gusgonnet](https://community.particle.io/u/gusgonnet)\
**Replies:** 1\
**Last updated:** [September 7, 2023, 3:52pm UTC](https://community.particle.io/t/particle-cli-build-set-product-version/65367 "2023-09-07T15:52:30Z")

</div>

Hi, with the new Particle CLI updates, I thought of asking this: is there a way to set PRODUCT\_VERSION() from a Particle CLI build command? I've looked into -D flags, or command line flags in general but no success y…

---

## [Lookup binaries.particle.io: i/o timeout](https://community.particle.io/t/lookup-binaries-particle-io-i-o-timeout/65305)

<div class="topic-metadata">

**Author:** [@tra757](https://community.particle.io/u/tra757)\
**Replies:** 2\
**Last updated:** [August 29, 2023, 5:49am UTC](https://community.particle.io/t/lookup-binaries-particle-io-i-o-timeout/65305 "2023-08-29T05:49:37Z")

</div>

I can't get past this. I have done a manual uninstall of Node, NPM and Particle CLI with no resolution. I have scoured the forums, but the resolution evades me and I have no idea what comes next. I'm running a MacBook…

---

## [\[ISSUE\]Network Error: Unable to upload or publish my library](https://community.particle.io/t/issue-network-error-unable-to-upload-or-publish-my-library/61280)

<div class="topic-metadata">

**Author:** [@abdullahmahboob](https://community.particle.io/u/abdullahmahboob)\
**Replies:** 5\
**Last updated:** [July 23, 2023, 3:54pm UTC](https://community.particle.io/t/issue-network-error-unable-to-upload-or-publish-my-library/61280 "2023-07-23T15:54:35Z")

</div>

Hello community, I’m using the CLI version 2.16.0 to upload a library I created, but it always ends with Network error from https://api.particle.io/v1/libraries. So I also tried publishing too but the same thing happens…

---

## [\[ISSUE\] Cloud compile fails, but local compile succeeds](https://community.particle.io/t/issue-cloud-compile-fails-but-local-compile-succeeds/64878)

<div class="topic-metadata">

**Author:** [@grillinmuffins](https://community.particle.io/u/grillinmuffins)\
**Replies:** 6\
**Last updated:** [July 9, 2023, 2:29pm UTC](https://community.particle.io/t/issue-cloud-compile-fails-but-local-compile-succeeds/64878 "2023-07-09T14:29:35Z")

</div>

Hello! Would love help with this. Read around similar posts but just can't figure out the solution for my context. My code compiles fine locally, but fails when I try to Cloud Compile. Running Particle Workbench on Mac…

---

## [CLI/Workbench Issues? Try Updating to Node 16](https://community.particle.io/t/cli-workbench-issues-try-updating-to-node-16/64657)

<div class="topic-metadata">

**Author:** [@Colleen](https://community.particle.io/u/Colleen)\
**Replies:** 0\
**Last updated:** [May 30, 2023, 9:48pm UTC](https://community.particle.io/t/cli-workbench-issues-try-updating-to-node-16/64657 "2023-05-30T21:48:32Z")

</div>

Hi everyone! I've noticed an uptick in CLI-related posts lately that all come back to the same issue- updating your node version to Node 16. Julien goes into more detail in this post, but the gist is that we recently up…

---

## [\[ISSUE\] SerialPort.list is not a function](https://community.particle.io/t/issue-serialport-list-is-not-a-function/62153)

<div class="topic-metadata">

**Author:** [@maximiliaan](https://community.particle.io/u/maximiliaan)\
**Replies:** 9\
**Last updated:** [May 25, 2023, 8:31am UTC](https://community.particle.io/t/issue-serialport-list-is-not-a-function/62153 "2023-05-25T08:31:19Z")

</div>

I reinstalled particle-cli in an attempt to fix path issues in MacOS Monterey and now I’m in a world of trouble: If I install particle-cli using the recommended method (straight from particle using curl), the particle …

[Next page](https://community.particle.io/c/dt/cli/52.md?page=1)
