Instalar Java 21 en Debian 13 y Debian 12

¿Quieres instalar Java 21 en tu servidor Debian 13 (Trixie) o Debian 12 (Bookworm)? Java 21 es la versión LTS actual, con un ciclo largo de actualizaciones, y la opción correcta para la mayoría de los proyectos nuevos. Esta guía muestra tres formas de instalarlo.

Requisitos previos

Necesitas un acceso SSH con permisos de root (o un usuario con permisos de sudo) en un Debian actual. Se recomiendan Debian 13 "Trixie" y Debian 12 "Bookworm". Debian 10 llegó al final de su soporte en junio de 2024 y ya no recibe actualizaciones de seguridad regulares, por lo que ha dejado de ser adecuado para el uso en producción.

Actualiza primero la lista de paquetes de tu sistema Debian e instala las actualizaciones disponibles:

apt update && apt upgrade -y

¿Qué versión de Java trae cada Debian?

Debian cambia las versiones de OpenJDK incluidas con cada versión principal. Para Java 21 esto significa que solo Debian 13 lo trae en el repositorio estándar, las versiones anteriores de Debian no. Esta tabla muestra lo que hay realmente en las fuentes de paquetes oficiales (datos de julio de 2026):

Puedes comprobar tú mismo en cualquier momento si un paquete está disponible en tu sistema:

apt-cache policy openjdk-21-jre-headless

Si en "Candidato" aparece un número de versión, puedes instalarlo directamente. Si ahí pone (ninguno), usa la vía de Temurin que se describe dos apartados más abajo.

Instalar Java 21 en Debian 13 desde el repositorio

Debian 13 incluye OpenJDK 21 de serie. Es la forma más sencilla y la que menos mantenimiento requiere, porque las actualizaciones de seguridad llegan automáticamente con apt upgrade:

apt install openjdk-21-jre-headless -y

La variante jre-headless contiene solo el entorno de ejecución, sin bibliotecas gráficas, y es por tanto la opción ligera y adecuada para un servidor. Si además necesitas un compilador, instala openjdk-21-jdk en su lugar.

También llegas al mismo resultado con el metapaquete default-jre-headless, ya que en Debian 13 apunta exactamente a Java 21. En Debian 12, en cambio, ese mismo metapaquete da Java 17, y en Debian 11, Java 11.

apt install default-jre-headless -y

Si tu aplicación no exige una versión principal concreta, esta es la vía con menos mantenimiento, porque no tienes que arrastrar el número de versión dentro del nombre del paquete.

Instalar Java 21 en Debian 12 con el repositorio de Adoptium

Debian 12 no incluye OpenJDK 21 en su fuente principal. A través del repositorio de Adoptium instalas Eclipse Temurin 21, una compilación libre de OpenJDK que también se actualiza con apt.

Configura primero la fuente de paquetes:

apt install -y wget gpg apt-transport-https ca-certificates

mkdir -p /etc/apt/keyrings

wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | tee /etc/apt/keyrings/adoptium.asc

echo "deb [signed-by=/etc/apt/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | tee /etc/apt/sources.list.d/adoptium.list

apt update

A continuación instalas Java 21:

apt install temurin-21-jre -y

El repositorio de Adoptium ofrece para Debian 13 las versiones de la 8 a la 26, y para Debian 12 está disponible esa misma fuente de paquetes. Si necesitas un compilador, usa temurin-21-jdk. Aquí la clave de firma se guarda como archivo propio en /etc/apt/keyrings/ y se asocia exactamente a este repositorio mediante signed-by= en la línea de sources. El antiguo comando apt-key está obsoleto desde Debian 11 y ya no debería usarse.

Alternativa: instalar Oracle JDK 21 como paquete

Si necesitas expresamente el JDK de Oracle, descarga el paquete directamente e instálalo con dpkg:

wget https://download.oracle.com/java/21/latest/jdk-21_linux-x64_bin.deb

dpkg -i jdk-21_linux-x64_bin.deb

Ten en cuenta dos cosas: el paquete no recibe actualizaciones a través de apt, así que tienes que estar pendiente de las nuevas versiones por tu cuenta. Además, el Oracle JDK tiene sus propias condiciones de licencia, que deberías revisar antes de usarlo en producción. OpenJDK y Eclipse Temurin, en cambio, se distribuyen bajo una licencia abierta.

Comprobar la instalación

Para terminar, verifica que la instalación ha salido bien. Consulta para ello la versión de Java instalada:

java -version

Si la salida contiene el número de versión 21, Java 21 está correctamente configurado.

Definir la versión de Java predeterminada

Si java -version muestra otra versión, es que todavía hay un JDK más antiguo definido como predeterminado. Lista primero todas las versiones de Java instaladas:

update-alternatives --list java

Después eliges de forma interactiva la versión que quieras de esa lista:

update-alternatives --config java

A continuación vuelves a comprobar con java -version si ya está activa la versión correcta.

Errores frecuentes y soluciones

"Unable to locate package openjdk-21-jre-headless": en Debian 12 y Debian 11 esto no es un fallo de tu instalación, porque ahí las fuentes de paquetes no contienen OpenJDK 21. En ese caso usa el repositorio de Adoptium del apartado dedicado a Debian 12.

dpkg informa de dependencias que faltan: ejecuta después apt install -f para que los paquetes que faltan se instalen automáticamente.

java -version muestra una versión antigua a pesar de la instalación: define la versión predeterminada con update-alternatives --config java.

¿Qué versión conviene para proyectos nuevos? Java 21 es una versión LTS y recibirá actualizaciones de seguridad durante muchos años. Para aplicaciones nuevas es, por lo general, mejor opción que Java 17 o versiones anteriores.