Flashing the firmware
The box runs from its memory card. You write our firmware image to the card once; after that, updates arrive over Wi-Fi from the box's setup page.
What you need
- The firmware image,
netstalgia-0.9.1-sdcard.img.xz(or newer), from Downloads. Use 0.8.9 or later: from that version the box sets itself up on its first start. - A microSD card of 2 GB or more. Everything on it will be erased.
- An image writer for your computer, such as balenaEtcher, or Raspberry Pi Imager with Use custom. Both read the
.xzfile directly: there is no need to unpack it.
Check the download
Before you flash, make sure the file arrived whole. Its SHA-256 checksum must match the one shown next to it on the Downloads page.
| Your computer | Type this |
|---|---|
| Windows | certutil -hashfile netstalgia-0.9.1-sdcard.img.xz SHA256 |
| macOS | shasum -a 256 netstalgia-0.9.1-sdcard.img.xz |
| Linux | sha256sum netstalgia-0.9.1-sdcard.img.xz |
If the numbers differ, download the file again. Don't flash an image whose checksum doesn't match.
Write the card
- Put the microSD card in your computer's card reader.
- Start the image writer and choose the
.xzfile. (In Raspberry Pi Imager: Choose OS, then Use custom.) - Choose the memory card. Check twice that it is the card and not one of your computer's disks.
- Write it, and wait for the writer to check the card afterwards.
- Eject the card and put it in the Pi.
The image holds no passwords, keys or Wi-Fi settings: every box makes its own on its first start.
Next: first-time setup.