Arm Performix

  Log an issue

  Fork and edit

  Discuss on Discord

About this Install Guide

Reading time:  30 min
Last updated:  30 Jun 2026
Reading time:
  30 min
Last updated:
  30 Jun 2026
Authors:Pareena Verma, Arm
Jai Adam Schrem, Arm
Official docs:View
Tags: Arm Performix
Authors:
  • Pareena Verma, Arm
  • Jai Adam Schrem, Arm
Official docs:
View
Tags:
Arm Performix

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.

What is Arm Performix?

Arm Performix is a desktop application that simplifies hardware-specific optimization by offering curated analysis pathways for performance-critical factors in applications, libraries, runtimes, and source code. Its capabilities include:

  • Performance profiling using hardware performance monitoring counters
  • Top-down methodology analysis for identifying performance bottlenecks
  • System-wide and per-process profiling
  • SSH-based remote target connections with optional support for jump nodes (also known as bastions)

Which host and target platforms does Arm Performix support?

The Arm Performix desktop application supports the following host platforms:

  • Windows: Windows 10 or later on Arm64 or x64 architecture
  • macOS: macOS on Arm64 (Apple Silicon) or x64 architecture
  • Linux: Debian-based distribution on Arm64 or x64 architecture

You also need a target system on which to profile your application or workload. The following target platforms are supported:

  • Linux with Arm64 architecture: Full support for Amazon Linux 2023, Ubuntu 22.04, or Ubuntu 24.04
  • Windows with Arm64 architecture: Partial support - Code Hotspots recipe only
  • Linux with x64 architecture: Partial support - Code Hotspots recipe only

How do I download and install Arm Performix?

Arm Performix is distributed as platform-specific installer packages. The installation includes the GUI, the CLI tool (apx) and an MCP server.

How do I install Arm Performix on a Windows host?

Download the Windows installer package for your architecture from the Arm Performix download page .

Alternatively, download using PowerShell. These commands require PowerShell and do not work in the Windows Command Prompt (CMD):

    

        
        

curl -o ArmPerformix-windows-arm64.exe https://artifacts.tools.arm.com/arm-performix/app/latest/windows/arm64/ArmPerformix-windows-arm64.exe


    

    

        
        

curl -o ArmPerformix-windows-x64.exe https://artifacts.tools.arm.com/arm-performix/app/latest/windows/x64/ArmPerformix-windows-x64.exe

After downloading the .exe file, locate it in your Downloads folder and double-click it to start the installation wizard.

Review the License Agreement and select I Agree.

Choose whether to install Arm Performix for all users or just yourself, then select Next.

If you choose Anyone who uses this computer (all users), a User Access Control dialog opens. Enter an administrator username and password, then select Yes.

Choose the installation directory. You can accept the default or select Browse to choose a different location.

Select Install.

When the installation finishes, select Finish to close the wizard.

How do I install Arm Performix on a Linux host?

Download the Linux installer package for your architecture from the Arm Performix download page .

Alternatively, download using wget:

    

        
        

wget -P $HOME https://artifacts.tools.arm.com/arm-performix/app/latest/linux/arm64/ArmPerformix-linux-arm64.deb


    

    

        
        

wget -P $HOME https://artifacts.tools.arm.com/arm-performix/app/latest/linux/x64/ArmPerformix-linux-amd64.deb

After downloading the .deb file, navigate to the directory where you downloaded it:

    

        
        
cd $HOME

Update the package list:

    

        
        
sudo apt update

Install the package:

    

        
        

sudo dpkg -i ArmPerformix-linux-arm64.deb


    

    

        
        

sudo dpkg -i ArmPerformix-linux-amd64.deb

The dpkg command may report missing dependency errors. Run the following command to automatically fetch and install any missing dependencies:

    

        
        
sudo apt-get install -f

Navigate to the Arm Performix installation directory:

    

        
        
cd "/opt/Arm Performix/assets/apx/"

Verify the installation by checking the version:

    

        
        
./apx version

The output shows the installed version number:

    

        
        Daemon process started; to stop call `apx daemon stop`.
Arm Performix CLI version: 1.0.0
Arm Performix daemon version: 1.0.0

How do I install Arm Performix on a macOS host?

Download the macOS installer package for your architecture from the Arm Performix download page .

Alternatively, download using curl:

    

        
        

curl -Lo ArmPerformix-darwin-arm64.pkg https://artifacts.tools.arm.com/arm-performix/app/latest/darwin/arm64/ArmPerformix-darwin-arm64.pkg


    

    

        
        

curl -Lo ArmPerformix-darwin-arm64.pkg https://artifacts.tools.arm.com/arm-performix/app/latest/darwin/x64/ArmPerformix-darwin-x64.pkg

After downloading the .pkg file, navigate to the directory where you downloaded it and double-click the file to start the installer.

Review the license agreement and select Agree.

Choose the installation destination. By default, Arm Performix installs on your system drive.

Select Install and enter your macOS administrator password when prompted.

Wait while the installer copies the files.

When the installation finishes, select Close to exit the installer.

How do I use the Arm Performix CLI?

The CLI is useful when you prefer command-line workflows, rather than GUI or MCP-driven workflows.

The apx command-line tool is installed automatically, and you can find the binary at the following locations on your host:

On Linux, you can find it at:

    

        
        
/opt/Arm\ Performix/assets/apx/apx

For convenience in the current shell session, add it to your PATH or create an alias:

    

        
        
export PATH="/opt/Arm Performix/assets/apx:$PATH"

On Windows, the default install location depends on the installation scope you chose during setup:

  • For a single-user install: C:\Users\<username>\AppData\Local\Programs\Arm Performix
  • For an all-users install: C:\Program Files\Arm Performix

Relative to the install location, the apx binary is at \assets\apx\apx.exe. For example, an all-users install places it at:

    

        
        
C:\Program Files\Arm Performix\assets\apx\apx.exe

For convenience in the current PowerShell session, add it to your Path. This example uses the all-users install path:

    

        
        
$env:Path += ";C:\Program Files\Arm Performix\assets\apx"

If you installed Arm Performix for a single user, replace C:\Program Files\Arm Performix with C:\Users\<username>\AppData\Local\Programs\Arm Performix.

On macOS, you can find it at:

    

        
        
/Applications/Arm\ Performix.app/Contents/assets/apx/apx

For convenience in the current shell session, add it to your PATH or create an alias:

    

        
        
export PATH="/Applications/Arm Performix.app/Contents/assets/apx:$PATH"

Use the CLI help for command-line usage, or for more detailed information see the Arm Performix User Guide :

    

        
        
apx --help

What comes next after installing Arm Performix?

After completing these installation steps, you can simply launch the GUI or CLI to get started.

For further guidance on using Arm Performix, including connecting to your target for the first time or setting up the MCP server to use Arm Performix with an AI agent, please refer to the Arm Performix User Guide .

How do I uninstall Arm Performix?

To remove Arm Performix from your system, use the appropriate method for your platform:

  • For Windows, open Settings > Apps, find Arm Performix, and select Uninstall.
  • For macOS, drag the Arm Performix application from Applications to the Trash.
  • For Linux, remove the package:
    

        
        
sudo apt remove arm-performix

Give Feedback

How would you rate this tool quick-install guide?