.. include:: /keyword.rst

===============================
Setup Build Environment (Linux)
===============================

To build images of |IOT-YOCTO| you need:

* Ubuntu 22.04 (LTS)
* At least 200 GiB of free disk space
* At least 16 GiB of system memory
* Internet connection

.. note::

   Building |IOT-YOCTO| with Ubuntu 22.04 has been verified by MediaTek. Using other distributions listed in
   `Yocto Reference Manual <https://docs.yoctoproject.org/4.0.13/ref-manual/system-requirements.html#supported-linux-distributions>`__ should also work, but MediaTek doesn't guarantee the compatibility.

On Ubuntu, use the following command to install the required packages:

.. prompt:: bash

    sudo apt-get install gawk wget git diffstat unzip texinfo gcc build-essential chrpath socat cpio python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping python3-git python3-jinja2 libegl1-mesa libelf-dev libsdl1.2-dev lz4 pylint xterm python3-subunit mesa-common-dev libstdc++-12-dev

And install the latest `repo tool <https://gerrit.googlesource.com/git-repo/+/refs/heads/master/README.md>`_:

.. prompt:: bash

    mkdir -p ~/bin
    PATH="${HOME}/bin:${PATH}"
    curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
    chmod a+rx ~/bin/repo

We recommend checking these package versions:

* ``git --version`` 1.8.3.1 or greater
* ``tar --version`` 1.27.1 or greater
* ``python3 --version`` 3.6.0 or greater
* ``gcc --version`` 5.0 or greater
* ``repo --version`` 2.16.6 or greater

.. note::

    The repo tool bundled in Ubuntu is usually outdated. It's recommended to install the latest version.