Amazon Corretto 21 Installation Instructions for Amazon Linux 2023

This topic describes how to install and uninstall Amazon Corretto 21 on a host or container running the Amazon Linux 2023 operating systems.

Option 1: Install using the yum Package Manager on Amazon Linux

Amazon Corretto 21 has a 'headless' variant available. This variant omits runtime dependencies that are typically associated with GUI applications such as X11 and ALSA and is worth considering for server-oriented workloads. The 'headful' variant adds support for X11 and ALSA. There is also a 'devel' package which contains the JDK development tools, as well as a 'jmods' package that contains the Amazon Corretto 21 JMods used to create custom runtime images.

Option 1: Install the headless Amazon Corretto 21:

sudo yum install java-21-amazon-corretto-headless

Option 2: Install the headful Amazon Corretto 21:

sudo yum install java-21-amazon-corretto

Option 3: Install the JDK for Amazon Corretto 21:

sudo yum install java-21-amazon-corretto-devel

Option 4: Install the JMods for Amazon Corretto 21:

sudo yum install java-21-amazon-corretto-jmods

The installation location is /usr/lib/jvm/java-21-amazon-corretto.<cpu_arch>.

Option 2: Download and Install RPMs Manually

1. Download RPMs from the Downloads page for your CPU architecture. To install the JDK, you will need to download the RPMs for both the JDK and the JRE.

2. Install using yum localinstall.

   sudo yum localinstall java-21-amazon-corretto*.rpm

Verify Your Installation

In the terminal, run the following command to verify the installation.

java -version

Expected output for 21.0.5:

openjdk version "21.0.5" 2024-10-15 LTS
OpenJDK Runtime Environment Corretto-21.0.5.11.1 (build 21.0.5+11-LTS)
OpenJDK 64-Bit Server VM Corretto-21.0.5.11.1 (build 21.0.5+11-LTS, mixed mode, sharing)

If you see a version string that doesn't mention Corretto, run the following command to change the default java or javac providers.

sudo alternatives --config java

If using the JDK you should also run:

sudo alternatives --config javac

Uninstall Amazon Corretto 21

You can uninstall Amazon Corretto 21 with the following commands.

Uninstall headless:

sudo yum remove java-21-amazon-corretto-headless

Uninstall headful:

sudo yum remove java-21-amazon-corretto

Uninstall devel:

sudo yum remove java-21-amazon-corretto-devel

Uninstall jmods:

sudo yum remove java-21-amazon-corretto-jmods