PiSCSI DOCUMENTATION
man 8

piscsi-network-profile

explicitly manage PiSCSI DaynaPort network profiles

PISCSI-NETWORK-PROFILE(8) System Manager's Manual PISCSI-NETWORK-PROFILE(8)

piscsi-network-profileexplicitly manage PiSCSI DaynaPort network profiles

piscsi-network-profile [--dry-run] [--console-acknowledge] apply bridge ethernet-interface

piscsi-network-profile [--dry-run] [--console-acknowledge] apply proxyarp wifi-interface

piscsi-network-profile [--dry-run] [--console-acknowledge] remove bridge | proxyarp

piscsi-network-profile creates or removes only the named NetworkManager connections and PiSCSI configuration used by the DaynaPort network adapter. It is not a general installer and does not modify existing user connections, routes, addresses, or firewall rules.

The bridge profile creates the named “PiSCSI wired bridge” and “PiSCSI wired bridge port” NetworkManager connections, then activates the bridge. It disables STP to avoid an unnecessary forwarding delay and pins the bridge MAC address to the selected physical Ethernet interface, keeping it distinct from the DaynaPort TAP MAC. It is the protocol-complete profile for a wired connection.

The proxyarp profile records the selected Wi-Fi uplink in /etc/piscsi/network.conf, reloads the PiSCSI runtime configuration, and disables the generic dhcp-helper.service to avoid a UDP/67 conflict with PiSCSI's DHCP relay. It requires the separately installed parprouted and dhcp-helper programs. Proxy ARP supports IPv4 unicast and DHCP only; it is not an Ethernet bridge and does not support IPv6, AppleTalk, multicast, mDNS, or other non-IP Ethernet traffic.

--dry-run prints the complete plan without changing the system. Applying or removing a profile requires root and NetworkManager. If --console-acknowledge is omitted, the command requires an interactive local terminal and an explicit “APPLY” response. Passing --console-acknowledge is explicit approval that skips the prompt. Use a local console or another recovery path: changing a network profile can interrupt connectivity.

Legacy PiSCSI NAT/firewall rules are never removed automatically. Remove them manually before selecting a supported profile.

sudo piscsi-network-profile --dry-run apply bridge eth0
sudo piscsi-network-profile --console-acknowledge apply bridge eth0
sudo piscsi-network-profile --dry-run apply proxyarp wlan0
sudo piscsi-network-profile --console-acknowledge apply proxyarp wlan0

piscsi(1), scsictl(1)

August 22, 2026 PiSCSI