Download and Installation
Downloads

There are highly optimized installation packages (for 32 Bit bullseye/bookworm and 64 bit bullseye/bookworm) with release versions and regular builds of the development version.

Installation/Update

SCSI2Pi is installed or updated in a matter of seconds. Just install the binary package:

>sudo apt install ./scsi2pi_BUILD_ARCH.deb

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

After the first installation you should check and adjust the default settings in /etc/s2p.conf, e.g. the default path for drive images.
During the installation the PiSCSI system service, if active, will be deactivated. The SCSI2Pi system service will be enabled instead. The standard installation path of the SCSI2Pi binaries and manpages is /opt/scsi2pi. You should add these paths to your environment, e.g. in .bash_profile:

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

De-installation

SCSI2Pi is de-installed with:

>sudo apt remove scsi2pi

Managing SCSI2Pi with the PiSCSI web UI

SCSI2Pi is compatible with the PiSCSI web UI, which you can install before or after installing SCSI2Pi. Thus SCSI2Pi just like PiSCSI can also be managed with a browser. Note that the PISCSI and SCSI2Pi system service cannot be running at the same time.
According to the usual standards the SCSI2Pi settings are managed in the separate configuration file /etc/s2p.conf and not like with PiSCSI in the startup file for the system service.

Compiling the sources

You can also compile SCSI2Pi yourself, e.g. for a customized build. The SCSI2Pi wiki provides more information.

Quickstart
  1. Download the suitable SCSI2Pi package and install it with sudo apt install ./scsi2pi_BUILD_ARCH.deb.
  2. 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).
  3. If you have edited /etc/s2p.conf, restart the system service with sudo systemctl restart s2p.