How to update
NOTE: This release has a number of breaking changes compared to PiSCSI v25.12.01 and earlier. A fresh installation is recommended; upgrade an older deployment only if you know exactly what you're doing.
- Option 1: Download the attached Debian deb packages for your architecture and install with
dpkg
| Hardware | Example Package |
|---|---|
| 64 bit ARM (RPi 2 v1.2 and later) | piscsi_26.8.1-1_arm64.deb |
| 32 bit ARMv7 (RPi 2 v1.1) | piscsi_26.8.1-1+armv7_armhf.deb |
| 32 bit ARMv6 with hard float (1st gen Zero and Zero W) | piscsi_26.8.1-1+armv6_armhf.deb |
sudo apt update
sudo apt install libprotobuf-dev libspdlog-dev libpcap-dev
sudo dpkg -i piscsi_26.8.1-1_arm64.deb- Option 2: On an existing or new git based PiSCSI installation, perform the following procedure:
cd ~/piscsi
git pull
git checkout v26.08.01Then follow the instructions in INSTALL.md to build the software.
NOTE: The officially supported OS for this release is Raspberry Pi OS Trixie.
Localization Stats
de: 123 translated messages, 80 fuzzy translations, 91 untranslated messages.
es: 123 translated messages, 80 fuzzy translations, 91 untranslated messages.
fr: 123 translated messages, 80 fuzzy translations, 91 untranslated messages.
sv: 123 translated messages, 80 fuzzy translations, 91 untranslated messages.
zh: 123 translated messages, 80 fuzzy translations, 91 untranslated messages.
What's Changed
Distribution and Base OS
The primary distribution method is now pre-build Debian deb packages, and the target OS is Raspberry Pi OS Trixie.
We have moved away from the pre-built images that you flash onto a microSD card, rather we recommend you use the stock Raspberry Pi Imager to create a fresh Trixie Lite installation (make sure you enable remote access with SSH), then install the Debian debs as described above.
This gives you the power and versatility of the stock RPi Imager, where you can choose your user and settings freely, with the binary builds that bypasses the need to wait for hours for the compiler to compile the C++ code on slow RPi hardware.
Notable New Features
This release contains a number of breaking changes that touches every part of the PiSCSI suite. You may need to update your scripts and workflows after upgrading. Many of these changes were made to enable and facilitate Debian deb packaging.
PiSCSI default data dirs have moved:
/home/pi/images -> /var/lib/piscsi/images
/home/pi/shared -> /var/lib/piscsi/shared
/home/pi/.config/piscsi -> /var/lib/piscsi/config
We also have a variable data dir in /var/lib/piscsi/data where we keep f.e. hard disk driver binaries. It is recommended that you move your files to the new locations, but the PiSCSI binaries can also take runtime arguments to point to the old locations if you prefer.
The connection profile (board types) is now selected at runtime rather than built in at compile time. Pass the -C argument to piscsi at launch, e.g. -C STANDARD, to select the type. As a result of this change, we no longer support the historical AIBOM board type due to its radically different logic and signalling.
We have moved away from the legacy bridge and iptables for DaynaPort networking, to a modern NetworkManager bridge and proxy ARP setup that was made for Raspberry Pi OS Trixie.
The entire suite of X68000 features that were removed after 2022 due to bitrot have been brought back now, including SASI hard drives and the Host Bridge device; special thanks to @gustavosarmento for all the diligent testing efforts! (The Ethernet adapter functionality is not yet full tested.)
The piscsi-web, piscsi-oled, and piscsi-ctrlboard applications have been rewritten from Python to Go for reliability and performance. The new versions have generally equivalent feature sets, with a few minute differences. Notably, piscsi-web not longer have user authentication, the ability to save reservation notes is removed, and the upload feature is simplified (but faster).
easyinstall.sh has been reduced to a companion app installation script. Use the build system and piscsi-network-profile tool to build and install piscsi and the network bridge.
piscsi
- Fix logging for unknown commands by @jbglaw in #1672
- bound CD-ROM READ TOC allocation length to the transfer buffer by @rdmark in #1745
- properly initialize piscsi controller before running test by @rdmark in #1749
- parprouted bridge for SCDP adapter by @rdmark in #1754
- restore support for SASI disk drive device by @rdmark in #1756
- fix NEC image sector size handling by @rdmark in #1757
- replace compile-time board types with runtime profiles by @rdmark in #1768
- restore X68000 Host Bridge support by @rdmark in #1764
scsidump
scsiloop
piscsi-web
- rewrite Web UI in Go by @rdmark in #1734
- piscsi-web: add support for MiniSCSI driver for HFS image creation by @rdmark in #1752
- improvements and bugfixes for piscsi-web etc. by @rdmark in #1763
piscsi-oled
- rewrite OLED monitor in Go by @rdmark in #1735
- improved horizontal scrolling and columns in OLED client by @rdmark in #1766
piscsi-ctrlboard
- rewrite Control Board client in Go by @rdmark in #1738
- ability to attach all devices in the Control Board UI by @rdmark in #1767
Miscellaneous
- correct example in scsictl man page by @rdmark in #1688
- create meson build scripts, improve tests and correctness by @rdmark in #1546
- remove obsolete Python code, move to Go client in containers by @rdmark in #1740
- bump copyright years to 2026 by @rdmark in #1750
- fix typo in piscsi documentation by @rdmark in #1751
- create Debian packaging files by @rdmark in #1747
- improve media workflows and version reporting in Go clients by @rdmark in #1753
- bump release version to 26.8.1 by @rdmark in #1755
- create a GitHub Pages website for documentation by @rdmark in #1758
- move compilation out of easyinstall.sh by @rdmark in #1759
New Contributors
Full Changelog: v25.12.01...v26.08.01
