Skip to content

Commit 1aa05c1

Browse files
anupras-mohapatra-armanupras-mohapatra-arm
committed
first pass on toolchains repo install guide
1 parent 89a37bd commit 1aa05c1

1 file changed

Lines changed: 64 additions & 93 deletions

File tree

‎content/install-guides/arm-toolchains-repository.md‎

Lines changed: 64 additions & 93 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Arm Linux Toolchains Repository
2+
title: Arm Toolchains repository
33

44
draft: true
55

@@ -17,7 +17,7 @@ test_images:
1717
- ubuntu:latest
1818

1919
official_docs: https://developer.arm.com/tools-and-software
20-
description: Configure the Arm Linux Toolchains Repository package archive on supported Linux AArch64 distributions to enable installing Arm Toolchains products using the system package manager.
20+
description: Configure the Arm Toolchains repository for Linux package archive on supported Linux AArch64 distributions to enable installing Arm Toolchains products using the system package manager.
2121
author: Gary Carroll
2222

2323
weight: 1 # Defines page ordering. Must be 1 for first (or only) page.
@@ -27,27 +27,23 @@ multitool_install_part: false # Set to true if a sub-page of a multi-page arti
2727
layout: installtoolsall # DO NOT MODIFY. Always true for tool install articles
2828
---
2929

30-
The Arm Linux Toolchains Repository provides a native and convenient way to install selected Arm software products on supported Linux hosts using the host operating system package manager.
30+
The [Arm Toolchains repository](https://developer.arm.com/packages/arm-toolchains/) provides a native and convenient way to install selected Arm software products on supported Linux hosts using the host operating system package manager.
3131

32-
The repository files are published at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/).
33-
34-
They are used to distribute Linux packages for Arm Toolchains, including:
32+
The repository files are used to distribute Linux packages for Arm Toolchains, including:
3533

3634
- Arm Toolchain for Linux
3735
- Arm Performance Libraries for supported compilers on Linux
3836

39-
Using the Arm Toolchains Linux Repository allows you to install, upgrade, and manage these products using standard Linux package-management tools such as `apt`, `dnf`, `yum`, and `zypper`.
40-
41-
Root or `sudo` permissions are required to install system packages.
42-
43-
{{% notice Repository signing key update July 2026 %}}
44-
Arm has recently reviewed and strengthened the repository management and publication processes used for the Arm Linux Toolchains Repository.
37+
Using the repository, you can install, upgrade, and manage these packages using standard Linux package-management tools such as `apt`, `dnf`, `yum`, and `zypper`.
4538

46-
As part of the continuing evolution of this release channel, Arm has revoked and replaced the signing key.
39+
To use the repository, you'll need to install the repository package. Arm provides an `arm-toolchains-repository` package for each supported Linux distribution. The package installs:
4740

48-
If you previously configured the Arm Linux Toolchains Repository, install the `arm-toolchains-repository` package version `2-2` or later before installing or upgrading Arm Toolchain for Linux or Arm Performance Libraries.
41+
- the Arm Toolchains repository definition for your Linux distribution
42+
- the Arm Toolchains repository signing public key
43+
- package manager configuration that associates the repository with the correct signing key
4944

50-
Existing installed copies of Arm Toolchain for Linux and Arm Performance Libraries continue to work.
45+
{{% notice Note %}}
46+
You need root or `sudo` permissions to install system packages.
5147
{{% /notice %}}
5248

5349
## Before you begin
@@ -58,43 +54,34 @@ Confirm you are using an Arm Linux system by running:
5854
uname -m
5955
```
6056

61-
The output should be:
57+
The output is similar to:
6258

6359
```output
6460
aarch64
6561
```
6662

67-
The commands in this guide use the native package manager for your distribution:
63+
Use the native package manager for your distribution:
6864

6965
- `apt` for Ubuntu LTS releases from 22.04
7066
- `dnf` or `yum` for RHEL 8 or later and Amazon Linux 2023
7167
- `zypper` for SLES 15 or 16
7268

73-
## What is the Arm Linux Toolchains Repository?
74-
75-
Arm provides an `arm-toolchains-repository` for each supported Linux distribution.
76-
77-
This package configures the Arm Linux Toolchains Repository on your host system.
78-
79-
The package installs:
80-
81-
- the Arm Toolchains repository definition for your Linux distribution
82-
- the Arm Toolchains repository signing public key
83-
- package manager configuration that associates the repository with the correct signing key
84-
85-
Install this repository package before you install Arm Toolchain for Linux or Arm Performance Libraries.
86-
8769
## About the signing key
8870

8971
Linux package managers use cryptographic signing keys to verify that repository metadata and packages are authentic and come directly from Arm.
9072

91-
If you are setting up a new system, installing the `arm-toolchains-repository` package automatically configures the current repository signing key for you. No manual key installation or fingerprint verification is required.
73+
In July 2026, Arm reviewed and strengthened the repository management and publication processes used for the Arm Toolchains repository. As part of the continuing evolution of this release channel, Arm has revoked and replaced the signing key.
74+
75+
If you're setting up a new system after July 2026, installing the `arm-toolchains-repository` package automatically configures the current repository signing key for you. You don't need to install the key manually or verify fingerprints.
9276

93-
However, if you are upgrading a system that previously configured the Arm Toolchains Linux repository before July 2026, you must update the repository configuration to use the new key. Otherwise, your package manager may refuse to refresh repository metadata or install packages.
77+
However, if you're upgrading a system that configured the Arm Toolchains repository for Linux before July 2026, you must update the repository configuration to use the new key.
78+
Otherwise, your package manager might refuse to refresh repository metadata or install packages.
79+
80+
Existing installed copies of Arm Toolchain for Linux and Arm Performance Libraries continue to work.
9481

9582
### Repository signing key fingerprints
9683

97-
For reference or manual verification, the fingerprints of the previous and current Arm Toolchains signing keys are:
84+
For reference or manual verification, the fingerprints of the previous and current Arm Toolchains signing keys are as follows.
9885

9986
Previous fingerprint:
10087

@@ -123,11 +110,28 @@ The output should show the current fingerprint:
123110
A406 5BCE 9386 DD1E 62FD E03B 8144 CA16 11A0 BD71
124111
```
125112

113+
## Previous repository locations
114+
115+
The current Arm Toolchains Linux Repository at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/) replaces the earlier repository structure that was based on repositories built using the SUSE Open Build Service.
116+
117+
Earlier repositories were published under the top-level package URL [https://developer.arm.com/packages/](https://developer.arm.com/packages/) and used repository prefixes such as:
118+
119+
```output
120+
ACfL:<distro>
121+
arm-toolchains:<distro>
122+
```
123+
124+
These earlier repositories are deprecated but will continue to work until further notice.
125+
126+
Don't configure new systems to use the deprecated `ACfL:` or `arm-toolchains:` repository paths. Migrate existing systems to the current Arm Toolchains Linux repositories and install the current `arm-toolchains-repository` package.
127+
128+
The deprecated repositories will be removed in a future update.
129+
126130
## Expected package manager errors
127131

128-
If your system still trusts only the previous Arm Linux Toolchains Repository signing key, package manager operations might fail when you refresh metadata, install packages, or upgrade packages.
132+
If your system still trusts only the previous Arm Toolchains Repository signing key, package manager operations might fail when you refresh metadata, install packages, or upgrade packages.
129133

130-
Ubuntu hosts may experience errors running the `apt update` command, for example:
134+
Ubuntu hosts might experience errors running the `apt update` command, for example:
131135

132136
```output
133137
Err:1 https://developer.arm.com/packages/arm-toolchains/ubuntu noble InRelease
@@ -136,7 +140,7 @@ W: An error occurred during the signature verification. The repository is not up
136140
W: Some index files failed to download. They have been ignored, or old ones used instead.
137141
```
138142

139-
RPM based hosts may download the new signing key but refuse to use it:
143+
RPM based hosts might download the new signing key but refuse to use it:
140144

141145
```output
142146
The GPG keys listed for the "Arm Toolchains" repository are already installed but they are not correct for this package.
@@ -145,15 +149,11 @@ Check that the correct key URLs are configured for this repository..
145149
Error: GPG check FAILED
146150
```
147151

148-
These errors are expected on systems that have not yet installed the updated repository package or accepted the new signing key.
152+
To resolve these errors, install the updated repository package and accept the new signing key.
149153

150-
Install the `arm-toolchains-repository` package version `2-2` or later for your Linux distribution, then refresh package metadata to resolve such errors.
154+
## Install the repository package directly
151155

152-
## Install the repository package
153-
154-
Install `arm-toolchains-repository` version `2-2` or later for your Linux distribution.
155-
156-
The examples below install the repository package directly from [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/). This allows you to update the repository configuration even if your package manager cannot currently refresh the Arm Toolchains repository metadata.
156+
Use one of the following commands to install the repository package [directly](https://developer.arm.com/packages/arm-toolchains/). This allows you to update the repository configuration even if your package manager can't currently refresh the Arm Toolchains repository metadata.
157157

158158
{{< tabpane code=true >}}
159159
{{< tab header="Ubuntu 24.04" language="bash" >}}
@@ -198,36 +198,10 @@ sudo zypper refresh
198198
{{< /tab >}}
199199
{{< /tabpane >}}
200200

201-
## Verify the repository package version
202201

203-
After installing the repository package, verify that version `2-2` or later is installed.
202+
## Install the repository package using manual recovery
204203

205-
{{< tabpane code=true >}}
206-
{{< tab header="Ubuntu" language="bash" >}}
207-
dpkg -l arm-toolchains-repository
208-
{{< /tab >}}
209-
{{< tab header="RPM-based distributions" language="bash" >}}
210-
rpm -q arm-toolchains-repository
211-
{{< /tab >}}
212-
{{< /tabpane >}}
213-
214-
The installed version should be `2-2` or later.
215-
216-
## Install Arm Toolchain for Linux
217-
218-
After installing the repository package, follow the [Arm Toolchain for Linux installation instructions](https://developer.arm.com/documentation/110477/latest/Installation) for your distribution.
219-
220-
The repository package must be installed first because it configures the package manager repository and the signing key used to verify packages.
221-
222-
## Install Arm Performance Libraries
223-
224-
After installing the repository package, follow the [Arm Performance Libraries installation instructions](https://developer.arm.com/documentation/102620/latest/Installation) for your distribution.
225-
226-
The repository package must be installed first because it configures the package manager repository and the signing key used to verify packages.
227-
228-
## Manual recovery
229-
230-
The recommended method is to install `arm-toolchains-repository` version `2-2` or later.
204+
The recommended method is to install `arm-toolchains-repository` version `2-2` or later directly.
231205

232206
Use manual recovery only if you cannot install the repository package directly.
233207

@@ -269,9 +243,9 @@ grep -Rns "developer.arm.com/packages/arm-toolchains/ubuntu" \
269243
/etc/apt/sources.list /etc/apt/sources.list.d
270244
```
271245

272-
If the command finds an existing entry, edit that entry so it references `/usr/share/keyrings/arm-toolchains-archive-keyring.gpg` using `signed-by`. Do not create a second entry for the same repository because `apt` may report conflicting `Signed-By` values.
246+
If the command finds an existing entry, edit that entry so it references `/usr/share/keyrings/arm-toolchains-archive-keyring.gpg` using `signed-by`. Don't create a second entry for the same repository because `apt` might report conflicting `Signed-By` values.
273247

274-
If the command does not find an entry, create `/etc/apt/sources.list.d/arm-toolchains.list` using the appropriate command below.
248+
If the command doesn't find an entry, create `/etc/apt/sources.list.d/arm-toolchains.list` using one of the following commands:
275249

276250
For Ubuntu 24.04, run:
277251

@@ -287,7 +261,7 @@ echo "deb [signed-by=/usr/share/keyrings/arm-toolchains-archive-keyring.gpg] htt
287261
sudo tee /etc/apt/sources.list.d/arm-toolchains.list
288262
```
289263

290-
Refresh package metadata:
264+
After creating `arm-toolchains.list`, refresh package metadata:
291265

292266
```bash
293267
sudo apt update
@@ -314,7 +288,7 @@ Check that the key is installed:
314288
rpm -qa gpg-pubkey*
315289
```
316290

317-
Refresh package metadata.
291+
Refresh package metadata by running one of the following set of commands.
318292

319293
For RHEL, Amazon Linux, and compatible RPM-based distributions:
320294

@@ -330,29 +304,26 @@ sudo zypper clean
330304
sudo zypper refresh
331305
```
332306

333-
## Previous repository locations
334-
335-
The current Arm Toolchains Linux Repository at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/) replaces the earlier repository structure that was based on repositories built using the SUSE Open Build Service.
336-
337-
Earlier repositories were published under the top-level package URL [https://developer.arm.com/packages/](https://developer.arm.com/packages/) and used repository prefixes such as:
307+
## Verify the repository package version
338308

339-
```output
340-
ACfL:<distro>
341-
arm-toolchains:<distro>
342-
```
309+
After installing the repository package, verify the installation:
343310

344-
These earlier repositories are deprecated but will continue to work until further notice.
311+
{{< tabpane code=true >}}
312+
{{< tab header="Ubuntu" language="bash" >}}
313+
dpkg -l arm-toolchains-repository
314+
{{< /tab >}}
315+
{{< tab header="RPM-based distributions" language="bash" >}}
316+
rpm -q arm-toolchains-repository
317+
{{< /tab >}}
318+
{{< /tabpane >}}
345319

346-
Do not configure new systems to use the deprecated `ACfL:` or `arm-toolchains:` repository paths. Existing users should migrate to the current Arm Toolchains Linux repositories and install the current `arm-toolchains-repository` package.
320+
The installed version should be `2-2` or later.
347321

348-
The deprecated repositories will be removed in a future update.
322+
## Next steps
349323

350-
## Summary
324+
After installing the repository package, you're ready to install the Arm Toolchain for Linux and the Arm Performance Libraries.
351325

352-
The Arm Linux Toolchains Repository provide a native package manager based installation channel for Arm Toolchain for Linux and Arm Performance Libraries on supported Linux hosts.
326+
For installation instructions, see the [Arm Toolchain for Linux installation instructions](https://developer.arm.com/documentation/110477/latest/Installation) and the [Arm Performance Libraries installation instructions](https://developer.arm.com/documentation/102620/latest/Installation) for your distribution.
353327

354-
To use the repositories, install `arm-toolchains-repository` version `2-2` or later for your Linux distribution. This package configures the repository and installs the current repository signing key.
355328

356-
Use only the current Arm Linux Toolchains Repository at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/).
357329

358-
Do not use the deprecated top-level `ACfL:` or `arm-toolchains:` repository paths for new installations.

0 commit comments

Comments
 (0)