# Add custom machine configurations

This explains how to define a custom machine configuration and build a custom image.

## Prerequisites:

To download Qualcomm Yocto and supporting meta layers, see [Build a BSP image](https://docs.qualcomm.com/doc/80-80022-254/topic/build_from_source_github_intro.html#build-a-bsp-image).

## Add a custom machine configuration and rebuild workspace

To add a custom machine configuration and rebuild the workspace, do the following:

1. To add a machine, add a new machine configuration file at
`layers/meta-qcom/conf/machine/`; for example,
`layers/meta-qcom/conf/machine/test-board.conf`.
2. If the new machine is using the QCS6490 hardware system-on-chip (SoC),
in the created file, add the following content:

#@TYPE: Machine
        #@NAME: TestBoard
        #@DESCRIPTION: Machine configuration for a development board, based on Qualcomm QCS6490
        
        require conf/machine/include/qcom-qcs6490.inc
        Copy to clipboard

    Add CI files under the `meta-qcom/ci` directory for the `test-board` configuration file.
3. Source the environment:

kas shell meta-qcom/ci/test-board.yml:meta-qcom/ci/qcom-distro-sota.yml:meta-qcom/ci/linux-qcom-6.18.yml
        Copy to clipboard
4. To build an image for the machine added, run the following command:

bitbake qcom-multimedia-image
        Copy to clipboard

Last Published: May 10, 2026

[Previous Topic
Customize Qualcomm Linux](https://docs.qualcomm.com/bundle/publicresource/80-80022-27/topics/customize_qualcomm_linux.md) [Next Topic
Add custom distribution configurations](https://docs.qualcomm.com/bundle/publicresource/80-80022-27/topics/add_custom_distro_configurations.md)