> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs-staging.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Build — RT with KVM

## **Building RT with KVM on QLI 2.0**

### Prerequisites — Sync QLI 2.0

```bash theme={null}
mkdir QLI2.0_rc3+20260513
cd QLI2.0_rc3+20260513/

git clone https://github.com/qualcomm-linux/meta-qcom-releases -b qli-2.0-rc3+20260513
kas checkout meta-qcom-releases/lock.yml
```

For full build-from-source instructions see the [official QLI build guide](https://docs.qualcomm.com/doc/80-80022-254/topic/build_from_source_github_intro.html?product=895724676033554725\&facet=Build%20Guide\&version=2.0-rc3).

***

### Selecting the RT Kernel and KVM via KAS

KVM support is added via the `qcom-distro-kvm.yml` KAS overlay. Combine it with the RT kernel overlay for your target:

```bash theme={null}
kas build meta-qcom/ci/iq-9075-evk.yml \
          :meta-qcom/ci/qcom-distro-kvm.yml \
          :meta-qcom/ci/linux-qcom-rt-6.18.yml \
          :meta-qcom/ci/lock.yml \
          :meta-qcom/ci/downloads.yml
```

| KAS Overlay | Purpose |
| - | - |
| `iq-9075-evk.yml` | Board / machine configuration |
| `qcom-distro-kvm.yml` | Enables KVM hypervisor and QEMU |
| `linux-qcom-rt-6.18.yml` | Selects the PREEMPT\_RT 6.18 kernel |
| `lock.yml` | Pins layer revisions for reproducibility |

> [!NOTE]
>
> The `xbl_config_kvm.elf` EFI binary is automatically included in the `qcomflash` package when `qcom-distro-kvm.yml` is selected — no manual UEFI BDS reconfiguration required.

***

### Verifying the RT Kernel at Runtime

After flashing, confirm the RT kernel is active (expected output contains `PREEMPT_RT`):

```bash theme={null}
root@iq-9075-evk:~# uname -a
Linux iq-9075-evk 6.18.30-01897-gd58ad5c480fa-dirty #1 SMP PREEMPT_RT Wed Jun 10 17:31:48 UTC 2026 aarch64 GNU/Linux

root@iq-9075-evk:~# uname -v
#1 SMP PREEMPT_RT Wed Jun 10 17:31:48 UTC 2026
```

### Verifying KVM at Runtime

```bash theme={null}
ls -la /dev/kvm
```

***

### Available Guest VM Image Recipes

QLI 2.0 does not ship a dedicated VM image recipe. Any of the following distro image recipes can serve as the guest VM image:

| Recipe | Description |
| - | - |
| `qcom-console-image.bb` | Minimal console image |
| `qcom-multimedia-image.bb` | Multimedia-capable image |
| `qcom-container-orchestration-image.bb` | Container runtime image |

Recipes are located under `<QLI2.0_Workspace_Path>/meta-qcom-distro/recipes-products/images`.

***

> [card] [RT Configuration](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-rt-config.md)
>
> Kernel boot parameters and Yocto RT tuning variables

> [card] [NIC & SR-IOV](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-nic-sriov.md)
>
> Intel X550 NIC and SR-IOV support on QLI 2.0

> [card] [VM Management](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm-vm-management.md)
>
> Virsh, libvirt, and sample domain XML files

> [card] [RT with KVM](https://dragonwingdocs-staging.qualcomm.com/Suites/Industrial-Edge-Suite/rt-with-kvm.md)
>
> Back to overview
