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

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

  * Follow the Yocto Project documentation on
    `how to install the essential packages`_ 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 --upgrade kas==|kas version| && sudo apt install python3-newt

    For more details on kas installation, see

    `kas Dependencies & installation`_.

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

    .. code-block:: text

      sudo apt install tmux telnet