Troubleshooting - Troubleshooting - 2026.1 English

Troubleshooting - Troubleshooting - 2026.1 English - UG1144

PetaLinux Tools Documentation: Reference Guide (UG1144)

Document ID

UG1144

Release Date

2026-06-23

Version

2026.1 English

This section describes some common issues you can experience while installing the PetaLinux tool. If the PetaLinux tool installation fails, the file petalinux_installation_log is generated in your PetaLinux installation directory.

Table 1. PetaLinux Installation Troubleshooting
Problem / Error Message	Description and Solution
`WARNING: You have less than 1 GB free space on the installation drive`	Problem Description: This warning message indicates that the installation drive is almost full. After the installation, you might need more space to develop the hardware or software project. Solution: Clean up the installation drive to clear some more free space. Alternatively, move the PetaLinux installation to another hard disk drive.
`WARNING: No tftp server found`	Problem Description: This warning message indicates that you do not have a TFTP service running on the workstation. Without a TFTP service, you cannot download Linux system images to the target system using the U-Boot network/TFTP capabilities. This warning can be ignored for other boot modes. Solution: Enable the TFTP service on your workstation. Contact your system administrator if you are unsure how to enable this service.
`ERROR: GCC is not installed - unable to continue. Please install and retry`	Problem Description: This error message indicates that you do not have gcc installed on the host workstation. Solution: Install gcc using your Linux workstation package management system. If you are unsure how to do this, contact your system administrator. See Installation Steps.
`ERROR: You are missing the following system tools required by PetaLinux: missing-tools-list` or `ERROR: You are missing these development libraries required by PetaLinux: missing-library-list`	Problem Description: This error message indicates that you do not have the required tools or libraries listed in the "missing-tools-list" or "missing-library-list." Solution: Install the packages of the missing tools. For more information, see Installation Requirements.
`./petalinux-v<petalinux-version>-final-installer.run: line 52: petalinux_installation_log: Permission denied`	Problem Description: This error message indicates that the PetaLinux installed directory does not have writable permissions. Solution: Set 755 permissions to the install directory.