..
 # SPDX-FileCopyrightText: <text>Copyright 2024-2025 Arm Limited and/or its
 # affiliates <open-source-office@arm.com></text>
 #
 # SPDX-License-Identifier: MIT

.. _build_host_environment_setup:

****************************
Build host environment setup
****************************

System requirements
===================

  * x86_64 or aarch64 host to build the stack and execute the FVP
  * Ubuntu Desktop or Server 22.04 Linux distribution
  * At least 500GiB of free disk for the download and builds
  * At least 32GiB of RAM memory
  * At least 12GiB of swap memory

.. note::
  You can copy all command examples on this page from the HTML document format by clicking the copy button.
  In the PDF document format, be aware that special characters are added when lines get wrapped.

Install dependencies
====================

  * Follow the Yocto Project documentation on
    :link_subs:`common:how-to-install-pkg` required for the build host. The
    packages needed to build the Yocto Project documentation manuals are not
    required.

  * Install the kas tool and its optional dependency (to use the "menu" plugin):

    .. code-block:: text
      :substitutions:

      sudo -H pip3 install -U pip && sudo -H pip3 install --upgrade kas==|kas version| && sudo apt install python3-newt python3-kconfiglib

    For more details on kas installation, see

    :link_subs:`common:kas-dep-installation`.

  * Install tmux and telnet (required for the ``runfvp`` tool):

    .. code-block:: text

      sudo apt install tmux telnet