1# System Configuration User Guide {#system_configuration} 2 3This system configuration guide describes how to configure a system for use with SPDK. 4 5# IOMMU configuration {#iommu_config} 6 7An IOMMU may be present and enabled on many platforms. When an IOMMU is present and enabled, it is 8recommended that SPDK applications are deployed with the `vfio-pci` kernel driver. SPDK's 9`scripts/setup.sh` script will automatically select `vfio-pci` in this case. 10 11However, some devices do not function correctly when bound to `vfio-pci` and instead must be 12attached to the `uio_pci_generic` kernel driver. In that case, users should take care to disable 13the IOMMU or to set it into passthrough mode prior to running `scripts/setup.sh`. 14 15To disable the IOMMU or place it into passthrough mode, add `intel_iommu=off` 16or `amd_iommu=off` or `intel_iommu=on iommu=pt` to the GRUB command line on 17x86_64 system, or add `iommu.passthrough=1` on arm64 systems. 18