# Qualcomm Linux Yocto documentation
Provides information about how Qualcomm^®^ Linux^®^ uses Yocto to build an embedded system software image for Qualcomm hardware.
## Qualcomm Linux Yocto overview
Qualcomm Linux Yocto Overview
Provides an overview of how to use the Yocto Project to customize Qualcomm Linux.
https://docs.qualcomm.com/doc/80-70023-27/topic/qualcomm_linux_yocto_overview.html#yocto-overview
## Qualcomm Linux metadata layers
meta-qcom
Contains Qualcomm device support and upstream OSS components.
https://docs.qualcomm.com/doc/80-70023-27/topic/meta_qcom.html#meta-qcom
meta-qcom-hwe
Contains machine configuration files that build software components for Qualcomm Linux.
https://docs.qualcomm.com/doc/80-70023-27/topic/meta_qcom_hwe.html#meta-qcom-hwe
meta-qcom-distro
Provides a reference distribution configuration for Qualcomm Linux.
https://docs.qualcomm.com/doc/80-70023-27/topic/meta_qcom_distro.html#meta-qcom-distro
meta-qcom-realtime
Provides patches and configurations for the Qualcomm Linux kernel to enable real-time operations.
https://docs.qualcomm.com/doc/80-70023-27/topic/meta_qcom_realtime.html#meta-qcom-realtime
meta-qcom-extras
Optional metadata layer, which enables source compilation of select components.
https://docs.qualcomm.com/doc/80-70023-27/topic/meta_qcom_extras.html#meta-qcom-extras
meta-qcom-qim-product-sdk
Provides Qualcomm^®^ Intelligent Multimedia (QIM) SDK and AI SDKs based on the GStreamer framework.
https://docs.qualcomm.com/doc/80-70023-27/topic/meta_qcom_qim_product_sdk.html#meta-qcom-qim-product-sdk
## Configure Qualcomm Linux software components
System initscripts
Add system initialization scripts to the image.
https://docs.qualcomm.com/doc/80-70023-27/topic/system_initscripts.html#system-initscripts-section
Configure and secure boot with systemd-boot and UKI
Provides options to control the boot flow and loads the user-selected boot loader.
https://docs.qualcomm.com/doc/80-70023-27/topic/configure_and_secure_boot_with_systemd_boot_and_uki.html#configure-and-secure-boot-with-systemd-boot-and-uki
Manage partitions in Qualcomm Linux
Describes how to add, delete, modify, and rename partitions.
https://docs.qualcomm.com/doc/80-70023-27/topic/managing_partitions_in_qualcomm_linux.html#managing-partitions-in-qualcomm-linux
Create a secondary virtual machine
Create VM images using the Qualcomm Linux build system.
https://docs.qualcomm.com/doc/80-70023-27/topic/create_secondary_virtual_machine.html#create-secondary-virtual-machine
Update firmware and OS on Qualcomm Linux using capsule and OSTree mechanisms
Keep devices up to date with on-the-air updates.
https://docs.qualcomm.com/doc/80-70023-27/topic/update_fw_and_os_qualcomm_linux_using_capsule_and_ostree_mechanisms.html#update-fw-and-os-qualcomm-linux-using-capsule-and-ostree-mechanisms
Boot Linux operating system from the SD card
Boot up development kits from the SD card.
https://docs.qualcomm.com/doc/80-70023-27/topic/boot_linux_operating_system_from_sdcard.html#boot-linux-operating-system-from-sdcard
## Customize Qualcomm Linux
Add custom machine configurations
Add a custom machine configuration and build an image.
https://docs.qualcomm.com/doc/80-70023-27/topic/add_custom_machine_configurations.html#add-custom-machine-configurations
Add custom distribution configurations
Add a custom distribution configuration file.
https://docs.qualcomm.com/doc/80-70023-27/topic/add_custom_distro_configurations.html#add-custom-distro-configurations
Add image recipes
Provides information on how to add image recipes.
https://docs.qualcomm.com/doc/80-70023-27/topic/add_image_recipes.html#add-image-recipes
## Debug
Debug
Resolve general problems and issues.
https://docs.qualcomm.com/doc/80-70023-27/topic/debug.html#debug1
Last Published: Dec 21, 2025
[Next Topic
Qualcomm Linux Yocto overview](https://docs.qualcomm.com/bundle/publicresource/80-70023-27/topics/qualcomm_linux_yocto_overview.md)