# Add custom distribution configurations

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

## Qualcomm-defined distribution configuration overview

The reference distribution defined for Qualcomm Linux is at
`<workspace>/layers/meta-qcom-distro/conf/distro/qcom-wayland.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

Note

[Distribution features](https://docs.yoctoproject.org/5.0.6/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-wayland.conf`, that is,
`cp qcom-wayland.conf test-distro.conf`.
3. Set `DISTRO_NAME = "Test Reference Distro with Wayland"` in the
`test-distro.conf` file.
4. Set `DISTROOVERRIDES = "test-dist"` in the `test-distro.conf` file.
5. Source the environment and export variables as follows:

MACHINE="qcs6490-rb3gen2-core-kit" DISTRO="test-distro" source setup-environment
        Copy to clipboard

After sourcing the environment, the current workspace directory changes
to `<workspace>/build-test-distro`. To verify if the `test-distro`
defined has taken effect, open the `conf/auto.conf` file to confirm the following:

# This configuration file is dynamically generated every time
    # set_bb_env.sh is sourced to set up a workspace.  DO NOT EDIT.
    #--------------------------------------------------------------
    DISTRO ?= "test-distro"
    Copy to clipboard

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.

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 must be 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.6/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: Jul 02, 2025

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