Skip to content

Download

The fastest way to run PiWalletSV is to flash the prebuilt SD-card image onto a microSD and boot. The image is a sealed appliance: it boots straight into the bonnet UI, has no SSH or Wi-Fi, and runs PiWalletSV as the only foreground task on the device.

Canonical host: signed firmware lives on GitHub Releases. The same download URLs are linked from piwalletsv.com and dev.piwalletsv.com — there is no separate “dev firmware.”

Current release

Release v0.1.0-r3 (0.1.0-r3, board pi0, beta) targets Raspberry Pi Zero / Zero W / Zero WH (32-bit armv6). Download from GitHub Releases or follow Build & deploy to reproduce the image from source.

Which image file?

Each release filename includes a board slug for the Raspberry Pi model (processor tier — not Wi‑Fi vs non‑W):

Board slug Raspberry Pi hardware
pi0 Pi Zero v1.3, Pi Zero W, Pi Zero WH
pi02w Pi Zero 2 W, Pi 3 Model B (future)
pi2 Pi 2 Model B (future)
pi4 Pi 4 Model B, Pi 400 (future)

For round‑1 kits use pi0.

Files (release v0.1.0-r3)

File Download
piwalletsv-0.1.0-r3-pi0-beta.img.xz Image (.xz)
piwalletsv-0.1.0-r3-pi0-beta.img.xz.asc OpenPGP signature
SHA256SUMS Checksums
SHA256SUMS.asc Signed checksums

Machine-readable manifest: releases/releases.json in the source repo.

Verify before you flash

The signing device's whole security claim is “keys never leave the device.” That claim collapses if the firmware running on the device is not the one we built. Verify the signature before you flash.

# One-time: import the release key (fingerprint in docs/security.md).
gpg --keyserver hkps://keys.openpgp.org --recv-keys 9E048B6E7F54C49DE2D5AEB5DA261F4F2B0CA281

# Verify the image.
gpg --verify piwalletsv-0.1.0-r3-pi0-beta.img.xz.asc \
 piwalletsv-0.1.0-r3-pi0-beta.img.xz

# Cross-check the SHA-256.
shasum -a 256 piwalletsv-0.1.0-r3-pi0-beta.img.xz

A successful verification ends with “Good signature” and the release-key fingerprint pinned in docs/security.md. Do not flash an unverified image.

Flash the image

Step-by-step flashing

Flash and first run § Flash the image covers Windows, macOS, and Linux (Raspberry Pi Imager or dd).

You need a USB microSD reader/writer on your computer. PiWalletSV kits include a microSD and SD adapter when a full kit is offered; they do not include a USB reader.

Next steps

Once the image is verified and flashed:

Building from source

Need a custom tree or no GitHub asset yet? Flash Raspberry Pi OS Lite 32-bit, run deploy/provision-pi.sh, and capture your own image — see Build & deploy and the operator notes in docs/includes/image-release-operator.md.