AutoVirt

July 14, 2026 ยท View on GitHub

AutoVirt

This project automates complex Linux virtualization tasks.

Instructions

Expand for details...

1. Clone Git repository

git clone --single-branch --depth=1 https://github.com/Scrut1ny/AutoVirt

2. Change directory

cd AutoVirt/

3. Execute

./main.sh
  • Experimental distro support:
EXPERIMENTAL=1 ./main.sh

4. Update repository

  • Make sure you're in the AutoVirt/ root directory when running the command below!
git fetch --all && git reset --hard origin/main

Supported Distros

DistroStatus
Arch basedSupported
Debian basedExperimental
Fedora basedExperimental
openSUSE basedExperimental

Prerequisites

  • git package
  • Supported Linux distribution
  • UEFI/BIOS Settings:
    • CPU virtualization extensions (VT-x / AMD-V)
    • IOMMU support (VT-d / AMD-Vi)
  • A dGPU for passthrough (recommended)

Troubleshooting

QEMU log

vfio 0000:01:00.0: failed to setup container for group 13: Failed to set group container: Invalid argument

dmesg log

vfio-pci 0000:01:00.0: Firmware has requested this device have a 1:1 IOMMU mapping, rejecting configuring the device without a 1:1 mapping. Contact your platform vendor.
  • Disable Pre-boot DMA Protection (Needed for VFIO)
    • (Change IOMMU from [Auto] to [Enabled] to find hidden setting)
Star History Chart