# 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-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

[Distribution features](https://docs.yoctoproject.org/5.0.11/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`.

1. 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
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.11/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: Oct 17, 2025

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