Installation Requirements - Installation Requirements - 2025.2 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)
Document ID
UG1144
Release Date
2025-11-20
Version
2025.2 English

The PetaLinux tools installation requirements are:

  • Minimum workstation requirements:
    • 8 GB RAM (recommended minimum for AMD tools)
    • 2 GHz CPU clock or equivalent (minimum of eight cores)
    • 100 GB free HDD space
    • Supported OS:
      • Completely removed CENTOS and RHEL to align with upstream Yocto.
      • Ubuntu Desktop/Server 22.04.3 LTS, 22.04.4 LTS and 22.04.5 LTS
      • OpenSuse Leap 15.4
      • AlmaLinux 8.10,9.4 and 9.5
  • You need access to install the required packages mentioned in the release notes. The PetaLinux tools need to be installed as non-root users.
  • PetaLinux requires standard development tools and libraries installed on your Linux host workstation. Install the libraries and tools listed in the release notes on the host Linux.
  • PetaLinux tools require your host system ​/bin/sh​ to be 'bash.' If you use Ubuntu distribution and your /bin/sh is 'dash,' consult your system administrator to change your default system shell /bin/sh with the sudo dpkg-reconfigure dash command.
Note: For package versions, refer to the PetaLinux 2025.2 Release Notes and Master Answer Record: 000037095.
Note: Use this workaround to build the PetaLinux project on the Ubuntu 24.04 release if you encounter a uid_map error. Use this link as one of several possible mitigations: Upstream workaround for uid_map error: https://lists.yoctoproject.org/g/yocto/message/63138.
echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns
CAUTION:
Consult your system administrator to clarify the correct host system package management procedures.
Important: PetaLinux 2025.2 works only with hardware designs exported from AMD Vivado™ Design Suite 2025.2.