Installer Java 21 sur Debian 13 et Debian 12

Vous souhaitez installer Java 21 sur votre serveur Debian 13 (Trixie) ou Debian 12 (Bookworm) ? Java 21 est la version LTS actuelle, avec un long approvisionnement en mises à jour, et c'est le bon choix pour la plupart des nouveaux projets. Ce guide présente trois méthodes d'installation.

Prérequis

Vous avez besoin d'un accès SSH avec les droits root (ou d'un utilisateur disposant des droits sudo) sur un Debian récent. Debian 13 « Trixie » et Debian 12 « Bookworm » sont recommandés. Debian 10 a atteint sa fin de support en juin 2024 et ne reçoit plus de mises à jour de sécurité régulières : il ne convient donc plus à un usage en production.

Commencez par actualiser la liste des paquets de votre système Debian, puis installez les mises à jour disponibles :

apt update && apt upgrade -y

Quelle version de Java fournit quel Debian ?

Debian remplace les versions d'OpenJDK incluses à chaque version majeure. Pour Java 21, cela signifie que seul Debian 13 le propose dans son dépôt standard, contrairement aux versions plus anciennes de Debian. Ce tableau montre ce qui se trouve réellement dans les sources de paquets officielles (situation en juillet 2026) :

Vous pouvez vérifier vous-même, à tout moment, si un paquet est disponible sur votre système :

apt-cache policy openjdk-21-jre-headless

Si un numéro de version apparaît sous « Candidat », vous pouvez installer directement. Si vous y lisez (aucun), utilisez la méthode Temurin présentée deux sections plus bas.

Installer Java 21 sur Debian 13 depuis le dépôt

Debian 13 fournit OpenJDK 21 d'origine. C'est la méthode la plus simple et la moins exigeante en maintenance, car les mises à jour de sécurité arrivent automatiquement via apt upgrade :

apt install openjdk-21-jre-headless -y

La variante jre-headless ne contient que l'environnement d'exécution, sans les bibliothèques graphiques : c'est donc le choix léger et adapté à un serveur. Si vous avez également besoin d'un compilateur, installez plutôt openjdk-21-jdk.

Vous obtenez le même résultat avec le métapaquet default-jre-headless, car sur Debian 13 il pointe précisément sur Java 21. Sur Debian 12, en revanche, ce même métapaquet donne Java 17, et Java 11 sur Debian 11.

apt install default-jre-headless -y

Si votre application n'exige pas une version majeure précise, c'est la méthode la moins exigeante en maintenance, puisque vous n'avez pas à suivre le numéro de version dans le nom du paquet.

Installer Java 21 sur Debian 12 via le dépôt Adoptium

Debian 12 ne contient pas OpenJDK 21 dans sa source principale. Le dépôt Adoptium vous permet d'installer Eclipse Temurin 21, un build OpenJDK librement disponible qui se met lui aussi à jour via apt.

Configurez d'abord la source de paquets :

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

Installez ensuite Java 21 :

apt install temurin-21-jre -y

Le dépôt Adoptium met à disposition les versions 8 à 26 pour Debian 13, et la même source de paquets est également disponible pour Debian 12. Si vous avez besoin d'un compilateur, prenez temurin-21-jdk. La clé de signature est ici placée dans un fichier distinct sous /etc/apt/keyrings/, et la ligne de sources l'associe précisément à ce dépôt grâce à signed-by=. La commande apt-key, autrefois courante, est dépréciée depuis Debian 11 et ne devrait plus être utilisée.

Alternative : installer Oracle JDK 21 en paquet

Si vous avez expressément besoin du JDK d'Oracle, téléchargez le paquet directement et installez-le avec dpkg :

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

dpkg -i jdk-21_linux-x64_bin.deb

Gardez deux points à l'esprit : le paquet ne reçoit aucune mise à jour via apt, vous devez donc surveiller vous-même les nouvelles versions. De plus, le JDK d'Oracle est soumis à ses propres conditions de licence, que vous devriez vérifier avant tout usage en production. OpenJDK et Eclipse Temurin sont en revanche publiés sous une licence ouverte.

Vérifier l'installation

Pour finir, contrôlez que l'installation a réussi. Interrogez pour cela la version de Java installée :

java -version

Si la sortie contient le numéro de version 21, Java 21 est correctement configuré.

Définir la version de Java par défaut

Si java -version affiche une autre version, c'est qu'un JDK plus ancien est encore défini par défaut. Commencez par lister toutes les versions de Java installées :

update-alternatives --list java

Sélectionnez ensuite la version souhaitée de manière interactive dans la liste :

update-alternatives --config java

Vérifiez enfin de nouveau avec java -version que la bonne version est bien active.

Erreurs fréquentes et solutions

« Unable to locate package openjdk-21-jre-headless » : sur Debian 12 et Debian 11, ce n'est pas une erreur de votre installation, car les sources de paquets n'y contiennent aucun OpenJDK 21. Utilisez dans ce cas le dépôt Adoptium décrit dans la section consacrée à Debian 12.

dpkg signale des dépendances manquantes : exécutez ensuite apt install -f pour que les paquets manquants soient installés automatiquement.

java -version affiche une version plus ancienne malgré l'installation : définissez la version par défaut avec update-alternatives --config java.

Quelle version pour de nouveaux projets ? Java 21 est une version LTS et bénéficie de mises à jour de sécurité pendant de nombreuses années. Pour de nouvelles applications, elle constitue donc en général un meilleur choix que Java 17 ou des versions plus anciennes.