Tutorial: Configure SPAL repository on AL2023 - Amazon Linux 2023
PrerequisitesChecking prerequisitesInstalling SPAL on your systemInstalling SPAL packagesDownloading SPAL source packagesInstalling SPAL debuginfo packagesUninstalling SPAL repository from your systemRelated topics
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

Tutorial: Configure SPAL repository on AL2023

Supplementary Packages for Amazon Linux (SPAL) is an additional package repository for AL2023 that provides customers access to thousands of open-source packages.

The following tutorial helps you configure the SPAL repository on your AL2023 instance. By installing the repository, you will gain access to all RPM packages available in SPAL. Once installed, you can use your package manager to install and use these packages on your system.

Prerequisites

This tutorial assumes that you have already launched an instance using AL2023 release version 2023.9.20251117 or later. For more information, see the AL2023 on Amazon EC2 and Updating AL2023 pages.

Checking prerequisites

  • To verify your instance satisfies the prerequisites, you can check the version of system-release installed on your system.

    To check the version of the package, you can use the following command.

    [ec2-user ~]$ rpm -qi system-release

    The command will display information about the package, including the major version.

    Name        : system-release
Version     : 2023.9.20251117
...
    Note

    Make sure to have the latest version of system-release installed. You can run sudo dnf upgrade to update to the latest version.

Installing SPAL on your system

  1. Install the spal-release package on your system. This adds the .repo configuration file and the GPG keys to your system.

    [ec2-user ~]$ sudo dnf install spal-release
    Note

    During the installation, the support statement will be displayed. The statement explains SPAL's scope of support and limitations. Please take time to review this information carefully.

  2. Verify the SPAL repository configuration was successfully added to your system.

    [ec2-user ~]$ cat /etc/yum.repos.d/amazonlinux-spal.repo

    You should see the three repositories configured on your system: amazonlinux-spal, amazonlinux-spal-source, and amazonlinux-spal-debuginfo.

    You can also check the list of configured repositories by running dnf repolist.

    [ec2-user ~]$ dnf repolist --all
    Note

    The --all flag is required to see both enabled and disabled repositories.

    All three SPAL repositories should be available. Note that the Amazon Linux 2023 SPAL repository - Source packages and Amazon Linux 2023 SPAL repository - Debug repositories are disabled by default.

    repo id                       repo name                                                status
amazonlinux-spal              Amazon Linux 2023 SPAL repository                        enabled
amazonlinux-spal-source       Amazon Linux 2023 SPAL repository - Source packages      disabled
amazonlinux-spal-debuginfo    Amazon Linux 2023 SPAL repository - Debug                disabled

Installing SPAL packages

  • Install SPAL packages on your system by running dnf install command.

    [ec2-user ~]$ sudo dnf install package
    Note

    You can use dnf list to see a complete list of SPAL packages. 

    [ec2-user ~]$ dnf list --repo=amazonlinux-spal
    Note

    SPAL is a versioned repository. Make sure to have the latest version of system-release installed to see the most recent list of packages.

    For more information on deterministic updates, you can check Deterministic upgrades through versioned repositories on AL2023

Downloading SPAL source packages

RPM source (SRPM) packages are primarily used by developers for building packages from source. The SPAL source repository is disabled by default. DNF automatically enables it when you use commands that require source packages.

To download the source RPM for an SPAL package, run the following command:

[ec2-user ~]$ dnf download --source package

Installing SPAL debuginfo packages

The debuginfo repository contains both debuginfo and debugsource packages. These packages provide debug symbols and source files that are useful for debugging and profiling applications. The SPAL debuginfo repository is disabled by default. DNF automatically enables it when you use commands that require debug packages.

To install debuginfo and debugsource packages for an SPAL package, run the following command:

[ec2-user ~]$ sudo dnf debuginfo-install package

Uninstalling SPAL repository from your system

  1. Remove the SPAL repository configuration using dnf remove command.

    [ec2-user ~]$ sudo dnf remove spal-release

  2. Verify the repository was removed by running dnf repolist command.

    [ec2-user ~]$ dnf repolist
    Important

    Removing the SPAL repository configuration from your system does not remove any SPAL packages installed on the system.

Related topics

For more information about the Supplementary Packages for Amazon Linux repository, see the following documentation: