Download and Installation
Downloads

There are highly optimized installation packages for 32/64 bit Raspberry Pi OS Bullseye/Bookworm/Trixie with release versions and regular builds of the development version. If you need SCSI2Pi binaries for other Linux distributions like Ubuntu or Manjaro, compile the sources.

Installation/Update

SCSI2Pi is installed or updated in seconds. Just install the Debian binary package for your Pi:

>sudo apt install ./scsi2pi_RELEASE_ARCH.deb

A warning like "Download is performed unsandboxed as root" can be ignored.

After the first installation you should adjust the settings in /etc/s2p.conf, e.g. the default path for drive images.
During the installation any existing PiSCSI system service will be deactivated. The SCSI2Pi system service will be created instead, but will by default not be started automatically. Note that the PiSCSI and the SCSI2Pi system service cannot be running at the same time. You can switch between these services any time.
The standard installation path of the SCSI2Pi binaries and manpages is /opt/scsi2pi. You should add these paths to your environment, e.g. in .profile or .bash_profile:

export PATH=/opt/scsi2pi/bin:$PATH
export MANPATH=/opt/scsi2pi/man:$MANPATH

The SCSI2Pi binaries installed with the Debian package can be started without root permissions.

De-installation

SCSI2Pi is de-installed with:

>sudo apt remove scsi2pi

Downgrade

If a downgrade is required, an older version can be installed like this:

>sudo apt --reinstall install ./scsi2pi_RELEASE_ARCH.deb

Please open a GitHub ticket, if due to a bug in a new release a downgrade is required.

Managing SCSI2Pi with the PiSCSI web UI

SCSI2Pi is compatible with the PiSCSI web UI, which you can install before or after installing SCSI2Pi. Unfortunately the web UI does not work with unknown device types, even though this would be possible in principle. Therefore, with SCSI2Pi you can disable device types in the API used by the web UI. To do this, launch s2p with -w SCSG,SCTP or enter the following in /etc/s2p.conf:

without_types=SCSG

This setting also affects the SCSI Control app, so that you cannot create these device types with the app anymore. The actual s2p functionality remains unchanged, though.

Managing SCSI2Pi without the PiSCSI web UI

SCSI2Pi can also be managed without the web UI. You can use the s2pctl tool (see the manpage for details) and/or the SCSI Control app.

Compiling the sources

You can also compile SCSI2Pi yourself, e.g. witout not needed device types for even more compact binaries. The SCSI2Pi wiki provides more information.

Quickstart
  1. Download the SCSI2Pi Debian package for your Pi and install it with sudo apt install ./scsi2pi_RELEASE_ARCH.deb.
  2. Start the system service with sudo systemctl start s2p, or start s2p manually with /opt/scsi2pi/bin/s2p.
  3. Create devices with the PiSCSI web UI, the SCSI Control app, s2pctl or with properties in the configuration file /etc/s2p.conf (for a permanent configuration).
  4. Note that after editing /etc/s2p.conf re-starting s2p is required.