# Add custom distribution configurations

The following explains how to add a custom distribution configuration and rebuild the workspace.

The reference distribution defined for Qualcomm Linux is at
`<workspace>/layers/meta-qcom-distro/conf/distro/qcom-distro.conf`.
To inspect the `DISTRO_FEATURES` variable, run the following command:

bitbake -e | grep ^DISTRO_FEATURES=
    Copy to clipboard

Output:

DISTRO_FEATURES="acl alsa argp bluetooth debuginfod ext2 ipv4 ipv6 largefile pcmcia usbgadget usbhost wifi xattr nfs zeroconf pci 3g nfc  vfat seccomp pam overlayfs acl xattr selinux ptest security virtualization tpm wayland vulkan opengl systemd pulseaudio gobject-introspection-data ldconfig"
    Copy to clipboard

[Distribution features](https://docs.yoctoproject.org/5.0.14/singleindex.html#distro-features) describe the `DISTRO_FEATURES` shown in the output.

## Add distribution configuration

To add a distribution configuration file, do the following:

1. Add a `test-distro.conf` file in
`<workspace>/layers/meta-qcom-distro/conf/distro`.
2. Use the same content as `qcom-distro.conf`, that is,
`cp qcom-distro.conf test-distro.conf`.
3. Set `DISTRO_NAME = "Test reference distribution"` in the
`test-distro.conf` file.
4. Set `DISTROOVERRIDES = "test-dist"` in the `test-distro.conf` file.
5. Use `meta-qcom/ci/qcom-distro.yml` as a reference to create a the `test-distro` distribution file.
6. To initialize the kas build environment, run the following command:

kas shell meta-qcom/ci/rb3gen2-core-kit.yml:meta-qcom/ci/test-distro.yml:meta-qcom/ci/linux-qcom-6.18.yml
        Copy to clipboard

After initializing the kas build environment, to verify if the `test-distro` has taken effect and to build the image, follow the steps:

1. To verify if the `test-distro` defined has taken effect, open the `conf/local.conf` file to confirm the following:

DISTRO ?= "test-distro"
        Copy to clipboard
2. To verify the output, run the following command:

bitbake -e | grep ^DISTROOVERRIDES=
        DISTROOVERRIDES="test-dist"
        Copy to clipboard

Note

If you have access to `meta-qcom-extras`, add it to `EXTRALAYERS ?=` `${WORKSPACE}/layers/meta-qcom-extras` in the `conf/bblayers.conf` file.
3. To rebuild the image, run the following command:

bitbake qcom-multimedia-image
        Copy to clipboard

## Enable or disable `DISTRO_FEATURES`

`DISTRO_FEATURES` provide a mechanism to verify which packages are included in the generated images.
You can select the features you want to enable through the `DISTRO_FEATURES`
variable, which is set or appended to in a `test-distro.conf` configuration file of a distribution.
For more information, see
[Distribution features](https://docs.yoctoproject.org/5.0.14/singleindex.html#distro-features).

Note

Select a feature defined by the community.

1. Open the `test-distro.conf` file and add the following line:

DISTRO_FEATURES:append = " cramfs"
        Copy to clipboard
2. Test if the change has taken effect, and then rebuild:

bitbake -e | grep ^DISTRO_FEATURES=
        Copy to clipboard

    The output is as follows:

DISTRO_FEATURES="acl alsa argp bluetooth debuginfod ext2 ipv4 ipv6 largefile pcmcia usbgadget usbhost wifi xattr nfs zeroconf pci 3g nfc  vfat seccomp pam overlayfs acl xattr selinux ptest security virtualization tpm usrmerge sota wayland vulkan opengl cramfs systemd pulseaudio gobject-introspection-data ldconfig"
        Copy to clipboard
3. To rebuild, run the following command:

bitbake qcom-multimedia-image
        Copy to clipboard

Last Published: May 10, 2026

[Previous Topic
Add custom machine configurations](https://docs.qualcomm.com/bundle/publicresource/80-80022-27/topics/add_custom_machine_configurations.md) [Next Topic
Add image recipes](https://docs.qualcomm.com/bundle/publicresource/80-80022-27/topics/add_image_recipes.md)