Web Serial · esptool
Flash the stock firmware
Put Solana OS, the badge’s stock firmware, on your badge straight from this page over USB. Nothing to install: no ESP-IDF, no esptool. Use it to update a badge or to bring one back from other firmware.
It’s the same build the emulator runs, so you can try it there first. To flash without the browser, download it.
- Version
- Solana OS 0.4.4
- Built
- Oct 28 2026 12:59:08 · ESP-IDF v5.5.4 · commit a5f7c13-dirty
- Source
- firmware/ in the repo. The emulator runs the same build
- Checks
- Each image is checked against its SHA-256 after download and its MD5 on the badge after writing
Loading…
Offline · esptool
Download it
No Chrome, or no internet where you’re flashing? Take the same images as a .zip and flash them from a terminal with esptool. The README inside explains how, with both erase options.
solana-os-0.4.4.zip
4 images, their checksums and a README
Unzip it and run this in the folder with esptool 5. PORT is the badge’s port: /dev/cu.usbserial-… on macOS, /dev/ttyUSB0 on Linux, COM3 or similar on Windows.
esptool --chip esp32c5 -p PORT -b 460800 --no-stub write-flash 0x2000 bootloader.bin 0x8000 partition-table.bin 0xf000 ota_data_initial.bin 0x20000 solana_os.binHand it on
Relink to a new profile
Giving the badge to someone else, or moving it to another account? Unlink it first, then let the new account claim it. !LAMPs, Guide pages, items, the X Dex and quest progress belong to the account, not the badge, so they stay with the old profile.
- 01
Release it
On your badge page, Release the badge. Or, with Wi-Fi on, use Factory reset in the badge’s Settings (SELECT twice): it releases the badge and wipes it.
- 02
Flash it (optional)
Choose Erase all data above for a clean badge. Without a release, the badge stays linked to its owner.
- 03
Join Wi-Fi
Turn the badge on, open Wi-Fi and SELECT a network. It rejoins that network at every boot when it is in range.
- 04
Scan the new QR
Open My Badge and scan its QR code with the new account’s phone. The new owner gets their own welcome if they never had one.