| Reading time: | 10 min |
| Last updated: | 4 May 2026 |
| Reading time: |
| 10 min |
| Last updated: |
| 4 May 2026 |
| Author: | Pareena Verma, Arm
|
| Official docs: | View |
| Tags: |
| Author: |
| Official docs: |
| View |
| Tags: |
This guide shows you how to install and use the tool with the most common configuration. For advanced options and complete reference information, see the official documentation. Some install guides also include optional next steps to help you explore related workflows or integrations.
Arm Performance Libraries provides developers with optimized math libraries for high-performance computing applications on Arm Neoverse-based hardware.
These libraries include highly-optimized functions for BLAS, LAPACK, FFT, sparse linear algebra, random number generation, libamath, and libastring.
Arm Performance Libraries are free to use and don’t require a license. These libraries are available for use on Windows 11 on Arm , macOS (Apple Silicon), and Linux (AArch64) hosts.
On your Windows 11 Arm machine, go to the
Arm Performance Libraries download page
.
Click the Download Windows section and download the Windows Installer:
arm-performance-libraries_<version>_Windows.msi
Double-click to open the installer and start the Arm Performance Libraries Setup Wizard.

Read and accept the End-User License Agreement by selecting the checkbox I accept the terms of this License Agreement.

Enter a location for the installation on your system. The default is:
C:\Program Files\Arm Performance Libraries

Click Install and then Finish to complete the installation.


To install Arm Performance Libraries from a command prompt and automatically accept the End User License Agreement, run:
msiexec.exe /i arm-performance-libraries_<version>_Windows.msi /quiet ACCEPT_EULA=1
To install Arm Performance Libraries using the winget package manager and automatically accept the End User License Agreement, run:
winget install --accept-package-agreements Arm.ArmPerformanceLibraries
You can now start linking your application to the Arm Performance libraries on your Windows on Arm device. Follow the examples in the included RELEASE_NOTES file of your extracted installation directory to get started.
For more information, see Get started with Arm Performance Libraries .
Download the appropriate package for your macOS distribution.
The following commands use Arm Performance Libraries version 26.01. The same commands work with other versions. Replace the file used in these steps with the file for your version of choice. To find the latest version, see Arm Performance Libraries downloads .
In a terminal, run the following command to download the macOS package:
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_26.01/arm-performance-libraries_26.01_macOS.tgz
Use tar to extract the file:
tar zxvf arm-performance-libraries_26.01_macOS.tgz
The output is similar to:
armpl_26.01_flang-21.dmg
Mount the disk image by running the following command from a terminal:
hdiutil attach armpl_26.01_flang-21.dmg
Now run the installation script as a superuser:
/Volumes/armpl_26.01_flang-21_installer/armpl_26.01_flang-21_install.sh -y
Using this command, you automatically accept the End User License Agreement and install packages to the /opt/arm directory. If you want to change the installation directory location, use the --install_dir= option with the script and provide the desired directory location.
To install Arm Performance Libraries using Homebrew in a terminal and automatically accept the End User License Agreement, run:
brew install arm-performance-libraries
The installer runs using sudo, so you may be asked to input your password.
To get started with Arm Performance Libraries on macOS, compile and test the examples in the /opt/arm/<armpl_dir>/examples/ directory, or <install_dir>/<armpl_dir>/examples/ if you installed to a different location.
For more information, see Get started with Arm Performance Libraries .
Arm Performance Libraries are supported on most Linux distributions such as Ubuntu, RHEL, SLES, and Amazon Linux on an AArch64 host. The libraries are compatible with various versions of GCC, LLVM, and NVHPC. The GCC-compatible releases are built with GCC 14 and tested with GCC versions 7 to 14. The LLVM-compatible releases are tested with LLVM 21.1. The NVHPC-compatible releases are tested with NVHPC 25.11.
Download the appropriate package for your Linux distribution. The deb-based installers can be used on Ubuntu 22 and Ubuntu 24. The RPM-based installers can be used on the following supported distributions:
The following instructions are for deb-based installers for GCC users.
The following commands use Arm Performance Libraries version 26.01. The same commands work with other versions. Replace the file used in these steps with the file for your version of choice. To find the latest version, see Arm Performance Libraries downloads .
In a terminal, run the following command to download the Debian package:
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_26.01/arm-performance-libraries_26.01_deb_gcc.tar
Use tar to extract the file and then change directory:
tar xf arm-performance-libraries_26.01_deb_gcc.tar
Run the installation script as a super user:
sudo ./arm-performance-libraries_26.01_deb/arm-performance-libraries_26.01_deb.sh --accept
Using the --accept switch, you automatically accept the End User License Agreement and the packages are installed to the /opt/arm directory.
If you want to change the installation directory location, use the --install-to option with the script and provide the desired directory location.
Arm Performance Libraries are available to install using Linux system package managers. The following instructions are for the Ubuntu system package manager apt command.
Add the Arm Performance Libraries apt package repository to your system:
. /etc/os-release
curl "https://developer.arm.com/packages/arm-toolchains:${NAME,,}-${VERSION_ID/%.*/}/${VERSION_CODENAME}/Release.key" | sudo tee /etc/apt/trusted.gpg.d/developer-arm-com.asc
echo "deb https://developer.arm.com/packages/arm-toolchains:${NAME,,}-${VERSION_ID/%.*/}/${VERSION_CODENAME}/ ./" | sudo tee /etc/apt/sources.list.d/developer-arm-com.list
sudo apt update
Download and install Arm Performance Libraries:
sudo apt install arm-performance-libraries
Install environment modules on your Linux machine:
sudo apt install environment-modules
Set your bash environment to use the modules:
source /usr/share/modules/init/bash
Set the MODULEPATH environment variable to point to the location of the installed modulefiles for Arm Performance Libraries:
export MODULEPATH=$MODULEPATH:/opt/arm/modulefiles
List the available modules:
module avail
The output is similar to:
armpl/26.01.0_gcc
Load the appropriate module:
module load armpl/26.01.0_gcc
To get started with Arm Performance Libraries on Linux, compile and test the examples in the /opt/arm/<armpl_dir>/examples/ directory, or <install_dir>/<armpl_dir>/examples/ if you installed to a different location.
For more information, see Get started with Arm Performance Libraries .
How would you rate this tool quick-install guide?
What is the primary reason for your feedback ?
Thank you! We're grateful for your feedback.