So, you think you “bricked” your Pico? Well, there’s a good chance you didn’t (explanation below) and the fix is pretty simple. When a Raspberry Pi Pico stops behaving normally — refusing to load firmware, failing to boot MicroPython, or showing up as a corrupted USB drive — the most reliable fix is to nuke it! This post will explain how to erase an RPI Pico flash memory. The simplest way to do that is with a special file known as NUKE.UF2, a tiny program that wipes the flash chip clean and reboots the board into a factory‑fresh state.
Raspberry Pi has now officially documented a universal NUKE.UF2 that works on every Pico model, including the newer Pico 2 and Pico 2W. This removes all confusion about board‑specific erase files.
This guide explains how NUKE.UF2 works, where to download it, and how to use it to recover any Pico board.
What NUKE.UF2 Does
NUKE.UF2 is a small UF2 payload that runs directly from the Pico’s bootloader. When copied to the board in BOOTSEL mode, it:
- Erases the entire QSPI flash chip
- Removes all MicroPython or CircuitPython files
- Clears corrupted filesystems
- Wipes leftover firmware fragments
- Reboots automatically
After the wipe, the board behaves exactly like a brand‑new Pico.
Works on All Pico Models (RP2040 and RP2350)
The universal NUKE.UF2 works on:
- Raspberry Pi Pico
- Raspberry Pi Pico H
- Raspberry Pi Pico W
- Raspberry Pi Pico WH
- Raspberry Pi Pico 2
- Raspberry Pi Pico 2W
This is possible because:
- RP2040 and RP2350 both support UF2 payloads
- Both chips allow RAM‑executed UF2 programs to issue flash‑erase commands
- The erase sequence is compatible across both families
So one NUKE.UF2 file can wipe every Pico variant.
When People Think They Bricked a Pico
Most “bricked” Raspberry Pi Pico boards aren’t bricked at all — they’re just stuck in a bad software state. Because the Pico’s bootloader lives in mask ROM, it cannot be erased or corrupted. As long as BOOTSEL mode still works, the board is recoverable.
Here are the most common situations where users believe they’ve bricked their Pico:
- Corrupted flash — A bad write, power loss during flashing, or filesystem corruption can prevent MicroPython or CircuitPython from booting. NUKE.UF2 clears the flash and restores normal behavior.
- Broken MicroPython filesystem — If the internal filesystem becomes inconsistent, the board may reboot-loop or refuse to mount as USB storage.
- Firmware crash loop — A buggy program can crash immediately on boot, making the board appear dead.
- Incorrect UF2 flashed — Flashing a UF2 meant for a different board or memory layout can soft-break the flash.
- CircuitPython filesystem errors — CircuitPython stores a full FAT filesystem on flash; corruption can prevent mounting or cause boot failures.
- Pico W Wi‑Fi firmware panic — A failed Wi‑Fi firmware update can cause repeated resets.
In all these cases, the Pico is not bricked — it’s just confused. And the fix is always the same:
- Use the official Raspberry Pi universal NUKE.UF2
- Wipe the flash
- Reinstall your firmware of choice
Because the bootloader is in ROM, the Pico is almost impossible to brick through software alone.
Where to Download the Official Universal NUKE.UF2
Raspberry Pi now publishes the official NUKE.UF2 inside their bootloader specification:
Official Raspberry Pi NUKE.UF2 Documentation (RP‑008273‑DS)
At the bottom of this web page is an explanation and link to the nuke.uf2 file.
This is the direct link to the file itself: https://pip.raspberrypi.com/documents/RP-008273-DS
This document contains:
- The official NUKE.UF2 download link
- Technical details of the UF2 erase mechanism
- Confirmation that the NUKE.UF2 is universal across all Pico models
This is the canonical, Raspberry‑Pi‑approved source.
How To Use NUKE.UF2 (All Pico Models)
1. Put the Pico into BOOTSEL mode
- Hold the BOOTSEL button
- Plug the board into your computer via USB
- Release the button
- A drive appears (RPI‑RP2 or RPI‑RP2350)
2. Drag NUKE.UF2 onto the USB drive
Copy the NUKE.UF2 file directly onto the mounted drive.
3. Wait for the board to reboot
The Pico will:
- Erase its entire flash
- Disconnect from USB
- Reboot automatically
Once it restarts, the flash is completely clean.
4. Reinstall your preferred firmware
You can now drag in:
- MicroPython UF2
- CircuitPython UF2
- A C/C++ SDK example UF2
If you are following along with our other posts on using the pico with the rpi_app_framework you can refer to this post to get your pico setup again.
Final Thoughts
NUKE.UF2 is the fastest, simplest, and most reliable way to recover any Raspberry Pi Pico, including the Pico 2. With Raspberry Pi now officially documenting the universal NUKE.UF2, you can confidently use a single file to restore any Pico board to a pristine state. This post explained how to erase an RPI Pico flash memory.