{"id":13581094,"url":"https://github.com/mateussouzaweb/kvm-qemu-virtualization-guide","last_synced_at":"2025-04-06T06:32:31.086Z","repository":{"id":49500391,"uuid":"467117587","full_name":"mateussouzaweb/kvm-qemu-virtualization-guide","owner":"mateussouzaweb","description":"Guide to run Virtual Machines with KVM and QEMU","archived":false,"fork":false,"pushed_at":"2025-04-01T10:29:01.000Z","size":241,"stargazers_count":110,"open_issues_count":1,"forks_count":14,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-01T11:30:32.744Z","etag":null,"topics":["gpu-passthrough","guide","kvm","linux","macos","qemu","vfio","virtual-machine","virtualization","windows"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mateussouzaweb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-03-07T14:01:17.000Z","updated_at":"2025-04-01T10:29:05.000Z","dependencies_parsed_at":"2024-01-16T21:21:22.419Z","dependency_job_id":"c237fd53-844b-46b3-b09d-bfd2aa24d961","html_url":"https://github.com/mateussouzaweb/kvm-qemu-virtualization-guide","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateussouzaweb%2Fkvm-qemu-virtualization-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateussouzaweb%2Fkvm-qemu-virtualization-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateussouzaweb%2Fkvm-qemu-virtualization-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mateussouzaweb%2Fkvm-qemu-virtualization-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mateussouzaweb","download_url":"https://codeload.github.com/mateussouzaweb/kvm-qemu-virtualization-guide/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247445652,"owners_count":20939952,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gpu-passthrough","guide","kvm","linux","macos","qemu","vfio","virtual-machine","virtualization","windows"],"created_at":"2024-08-01T15:01:58.048Z","updated_at":"2025-04-06T06:32:31.079Z","avatar_url":"https://github.com/mateussouzaweb.png","language":"Shell","funding_links":[],"categories":["Shell","Others"],"sub_categories":[],"readme":"# KVM / QEMU Virtualization Guide\n\nThis guide is based on my own experience and hacks on running virtual machines. You already may have knowledge on this topic, so I will try to keep things simple and get directly to the point.\n\nOur object is just one: have a **full working virtualization platform with QEMU using KVM as hypervisor** to run Linux, MacOS, Windows OS and any other operational system inside virtual machines with great performance, even for gaming! \n\n----\n\n## What to Expect\n\n- Virtualization solution with Fedora as hypervisor.\n- Instructions for traditional and immutable systems.\n- Easy guide if you already have KVM / QEMU knowledge.\n- Virtualization that just works.\n- Up to date guide that explores the features of modern VFIO software.\n- Best practices for maximum performance in VMs.\n- Isolated and secure host system to just run VMs.\n- Linux, Windows and MacOS virtualization.\n- Single and Multi GPU passthrough support (very easy to activate/deactivate).\n- PCI passthrough ON DEMAND without need to pre-allocate devices on VFIO (or blacklist drivers on the OS).\n- Audio and USB device passthrough.\n- Live USB passthrough on supported VMs.\n- CPU isolation and pinning support.\n- Bridge network to keep every VMs available on the local network.\n- Nested virtualization for development environments.\n- VM creation and management from CLI.\n- Support for BOOT interface via CLI (to select the startup disk for example).\n- More!\n\n## My Current Setup\n\nJust to provide additional context, here is my current hardware configuration:\n\n- Motherboard: ASRock X570 Phantom Gaming 4\n- Memory: Corsair Vengeance 32GB 2666MHz DDR4\n- CPU: AMD Ryzen 5700X\n- GPU: AMD RX 6700XT XFX QICK 319 12GB\n- SSD: Crucial SSD P2 2TB NVMe PCIe M.2\n\nThis guide also was previously tested with the following hardware:\n\n- Motherboard: Gigabyte B450 Aorus Pro Wifi\n- Memory: Corsair Vengeance 16GB 2133MHz DDR4\n- CPU: AMD Ryzen 1700X\n- GPU: AMD RX 5500XT Gigabyte Gaming OC 4G\n- GPU: Nvidia GTX 1070 Gigabyte G1 Gaming 8GB\n\n## How to Start\n\nFollow the guides inside the ```Docs``` folder or use the links below for a specific topic:\n\n- **[Host System Installation](Docs/00%20-%20Installation.md)**\n- **[Configuring the Bridge Network](Docs/01%20-%20Bridge%20Network.md)**\n- **[Enabling PCI-e Passthrough](Docs/02%20-%20PCI-e%20Passthrough.md)**\n- **[Virtualization Hooks](Docs/03%20-%20Virtualization%20Hooks.md)**\n- **[Managing Virtual Machines](Docs/04%20-%20Virtual%20Machine%20Management.md)**\n- **[XML Configurations](Docs/05%20-%20XML%20Configurations.md)**\n- **[Linux Virtualization](Docs/06%20-%20Linux%20Virtualization.md)**\n- **[Windows Virtualization](Docs/07%20-%20Windows%20Virtualization.md)**\n- **[MacOS Virtualization](Docs/08%20-%20MacOS%20Virtualization.md)**\n- **[File Sharing](Docs/09%20-%20File%20Sharing.md)**\n- **[Docker Containers](Docs/10%20-%20Docker%20Containers.md)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateussouzaweb%2Fkvm-qemu-virtualization-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmateussouzaweb%2Fkvm-qemu-virtualization-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmateussouzaweb%2Fkvm-qemu-virtualization-guide/lists"}