Download and Installation
Downloads

There are highly optimized installation packages (for 32 Bit bullseye/bookworm/trixie and 64 bit bullseye/bookworm/trixie) 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_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 the PiSCSI system service, if active, will be deactivated. The SCSI2Pi system service will be created instead, but will not be started automatically. Note that the PiSCSI and the SCSI2Pi system service cannot be running at the same 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

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 cannot cope with unknown device types, even though this would not be a technical problem. Therefore, 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,SCTP

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. 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_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.