Skip to main content
Set up your host computer before building or modifying the Qualcomm® Linux kernel. The requirements below apply to both the Yocto-based and standalone build workflows.

Host computer requirements

Table: Minimum host requirements
Building on a virtual machine is supported but significantly slower. For VM setup instructions, see the Qualcomm Linux Virtual Machine Setup Guide.

Required tools

Table: Required tool versions

Install host packages

Run the following commands to install the required packages and the kas build tool:
Restart your shell (or run source ~/.bashrc) so that the pipx binary is on your PATH, then install kas:
Optionally, download the kas-container script to run builds inside a Docker container on any Linux distribution:

Configure locales

Configure git

Standalone kernel development prerequisites

The standalone build workflow uses the kmake-image Docker container to provide the cross-compilation toolchain, systemd ukify, and image-packaging scripts. Docker must be installed on the host before running a standalone build.

Install Docker CE

To install Docker on Ubuntu, follow the instructions in the Docker installation guide.

Add your user to the docker group

Restart the terminal, or log out and log back in, to apply the updated docker group membership.

Verify the installation

Pull the kmake-image Docker image

The primary approach is to pull the pre-built kmake-image from the registry:
Pull the hosted image, and then build the image locally only if you need to develop or customize it. The kmake-image container build and shell alias setup are covered in Build the kernel without Yocto.

Repository access

The Qualcomm Linux kernel and meta-qcom layer are publicly hosted on GitHub and require no special credentials: