Install BOLT on Linux

Install BOLT on Linux

This guide requires LLVM BOLT 22.1.0 or later for SPE profiling and required options. Package manager versions might be older, so verify the installed version before continuing.

Install BOLT from LLVM releases

Install BOLT from a prebuilt LLVM release . This method provides a consistent version across systems. It also lets you use newer releases when available. The following example uses LLVM 22.1.0.

Download and extract LLVM:

    

        
        
wget https://github.com/llvm/llvm-project/releases/download/llvmorg-22.1.0/LLVM-22.1.0-Linux-ARM64.tar.xz
tar xf LLVM-22.1.0-Linux-ARM64.tar.xz

    

Add LLVM tools to your PATH:

    

        
        
export PATH="$(pwd)/LLVM-22.1.0-Linux-ARM64/bin:$PATH"

    

Install BOLT using a package manager

Use a package manager if you prefer a system-managed installation. Package versions depend on your Linux distribution.

    

        
        

sudo apt update
sudo apt install llvm-bolt


    

    

        
        

sudo dnf install llvm-bolt


    

    

        
        

sudo zypper install llvm-bolt


    

BOLT is available on Ubuntu 25.04 and later, Debian 13 and later, Fedora 42 and later, and on openSUSE Tumbleweed.

Verify the installation

    

        
        
llvm-bolt --version

    

The command prints the BOLT version. If the command fails, check your PATH.