Shadowfetch Linux / Try it first

Try it in a virtual machine

Run the same shadowfetch-5.0.0-amd64.iso in a virtual machine on the Linux computer you already have: boot the live session, or install it to a virtual disk, without touching your own disk.

What you need

  • The ISO, shadowfetch-5.0.0-amd64.iso (4.09 GB (3.81 GiB)), from the download page. Check it first on the verify page: a VM boots a corrupted file no better than a computer does.
  • A 64-bit Intel or AMD host with hardware virtualization turned on in its firmware (Intel VT-x or AMD-V). The ISO is amd64 only. On an Apple silicon Mac a VM app would have to emulate an x86-64 processor, which is much slower; this guide does not cover that.
  • Enough room on the host to give the VM the resources below on top of what the host itself uses.

Resources to give the VM

These are the minimums from the hardware notes. More memory and cores make it smoother.

PartGive it
CPU2 cores or more
Memory4 GB or more
Disk40 GB or more
Graphics3D acceleration on, if your hypervisor supports it
FirmwareBIOS, or UEFI without Secure Boot

The image is not signed for Secure Boot, so a VM with Secure Boot on will not start it. The ISO boots with both BIOS and UEFI firmware: pick BIOS, or a UEFI firmware without Secure Boot. Why Secure Boot has to be off.

GNOME Boxes

The simplest option on a GNOME desktop. Install it from your distribution's software centre or from Flathub (org.gnome.Boxes).

  1. Open Boxes and press +, then choose to create a virtual machine.
  2. Choose to install from a file (the label is Operating System Image File or Install from File, depending on the version) and select shadowfetch-5.0.0-amd64.iso.
  3. If Boxes asks for a template or does not recognise the image, choose a Debian or generic Linux one: Shadowfetch Linux is built on Debian testing.
  4. On the review screen, set memory to at least 4 GB and the storage limit to at least 40 GB. If there is an EFI option, you can leave it off: the image boots with BIOS as well.
  5. Create the box. It starts the ISO's live session. To install, follow the install guide from the live session, as on a real computer.
  6. For smoother graphics, open the box's preferences and turn on 3D acceleration if your version offers it.

virt-manager (QEMU/KVM)

More control, the same QEMU/KVM engine that took the screenshots on this site. Install the virt-manager package from your distribution; it needs the libvirt service running.

  1. Choose File › New Virtual Machine, then Local install media (ISO image or CDROM).
  2. Browse to shadowfetch-5.0.0-amd64.iso. If the operating system is not detected, turn off automatic detection and choose Debian testing.
  3. Give it at least 4096 MiB of memory and 2 CPUs, then create a disk of at least 40 GB.
  4. On the last screen, tick Customize configuration before install and press Finish.
  5. In Overview, set Firmware to BIOS, or to a UEFI entry without Secure Boot (one whose name does not contain secboot).
  6. For 3D acceleration, set Video to Virtio with 3D acceleration ticked, and Display Spice to listen type None with OpenGL ticked. This needs working 3D graphics on the host; if the VM shows a black screen, turn both off again.
  7. Press Begin Installation. The live session starts; install from it with the install guide.

If the VM boots the ISO again after installing, remove the ISO from the virtual CD drive (in virt-manager, the SATA CDROM device, Disconnect) and restart it.

Other hypervisors

Shadowfetch Linux boots in common VMs, so VirtualBox, VMware and others work the same way: a new 64-bit Debian or Linux VM with the resources above, the ISO in its virtual CD drive, and Secure Boot off. Their screens differ by version, so this page does not walk through them.

What a VM does not tell you

  • Graphics speed. Rendering in a VM proves nothing about a physical GPU. QXL video can report no DRM render node (gpu-verify-failed); that is the known VM caveat, not a desktop failure. On a VM with no render node, Shadowfetch sets WEBKIT_DISABLE_DMABUF_RENDERER=1 for the session so ShadowCode does not idle at high CPU.
  • Your own hardware. Wi-Fi, Bluetooth, NVIDIA drivers, hybrid laptops and your firmware's boot menu can only be checked on the real computer. The hardware notes cover what to look for.
  • Known issues still apply. The live session and the installed system in a VM are the same as on a computer; see known issues.

Ready for the real thing? Download the ISO, write it to a USB stick, and follow the install guide.

Buy Me a Coffee