Installer Java 17 sur Debian 13 et Debian 12

Vous souhaitez installer Java 17 sur votre serveur Debian ? Un point important d'abord : le fait qu'un simple apt install suffise dépend de votre version de Debian. Debian 12 (Bookworm) fournit OpenJDK 17, alors que Debian 13 (Trixie) ne le propose plus. Ce guide présente la méthode adaptée à chacun des deux cas.

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. Nous recommandons Debian 13 « Trixie » et Debian 12 « Bookworm ». 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 : ce système ne convient donc plus à un usage en production.

Cette commande vous indique quelle version de Debian tourne sur votre serveur :

cat /etc/os-release

Mettez ensuite à jour la liste des paquets et appliquez les mises à jour disponibles :

apt update && apt upgrade -y

Quelle version de Java pour quelle version de Debian ?

Debian renouvelle les versions d'OpenJDK fournies à chaque nouvelle version majeure. Un tutoriel qui recommande systématiquement apt install openjdk-17-jre-headless échoue donc sur Debian 13. Ce tableau montre ce qui se trouve réellement dans les dépôts officiels (état : juillet 2026) :

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

apt-cache policy openjdk-17-jre-headless

Si un numéro de version s'affiche en face de « Candidat », vous pouvez installer directement. Si vous y lisez (aucun), passez par la méthode Temurin décrite plus bas.

Installer Java 17 sur Debian 12

Sur Debian 12 (comme sur Debian 11), OpenJDK 17 se trouve dans le dépôt officiel. Une seule commande suffit :

apt install openjdk-17-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é pour un serveur, par exemple pour un serveur Minecraft ou une application web Java.

Si vous avez besoin en plus d'un compilateur parce que vous compilez vos applications Java directement sur le serveur, installez le JDK complet :

apt install openjdk-17-jdk -y

Installer Java 17 sur Debian 13 via le dépôt Adoptium

Debian 13 ne contient plus OpenJDK 17 : la version fournie y est Java 21. Si votre application exige explicitement Java 17, installez Eclipse Temurin. Il s'agit d'un build OpenJDK librement disponible, distribué via son propre dépôt et mis à jour ensuite tout à fait normalement avec apt.

Installez d'abord les paquets utilitaires et créez le répertoire destiné aux clés de dépôt :

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

mkdir -p /etc/apt/keyrings

Téléchargez ensuite la clé de signature et ajoutez le dépôt. La ligne sources renvoie explicitement à cette seule clé grâce à signed-by=, si bien qu'elle ne vaut que pour ce dépôt précis :

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 17 :

apt install temurin-17-jre -y

Si vous avez besoin d'un compilateur ici aussi, installez plutôt temurin-17-jdk. Pour Debian 13, le dépôt Adoptium met à disposition les versions 8 à 26 : vous ne dépendez donc pas du choix de votre distribution. Ce même dépôt est également disponible pour Debian 12.

Alternative : utiliser la version par défaut de Debian

Si votre application n'exige pas une version précise de Java mais simplement un Java récent, le métapaquet est la solution la plus confortable. Il installe automatiquement la version que votre distribution prévoit par défaut :

apt install default-jre-headless -y

Selon la version de Debian, vous obtenez le Java suivant :

Sur Debian 12, vous obtenez donc exactement le Java 17 souhaité, sans avoir à gérer vous-même le numéro de version dans le nom du paquet.

Vérifier l'installation

Contrôlez pour finir que l'installation a bien abouti. Il suffit pour cela d'interroger la version de Java installée :

java -version

Si la sortie commence par openjdk version "17, Java 17 est correctement configuré et prêt à l'emploi.

Gérer plusieurs versions de Java en parallèle

Si plusieurs JDK sont installés sur le serveur, c'est le système alternatives qui détermine quelle version démarre réellement lors de l'appel de java. Voici comment lister toutes les versions présentes :

update-alternatives --list java

Vous sélectionnez ensuite la version par défaut souhaitée de façon interactive dans la liste :

update-alternatives --config java

Si une application a besoin en plus de la variable d'environnement JAVA_HOME, relevez le chemin dans cette liste et inscrivez-le durablement dans /etc/environment :

JAVA_HOME="/usr/lib/jvm/java-17-openjdk-amd64"

Encore sous Debian 11 ?

Debian 11 « Bullseye » ne reçoit plus que des mises à jour de sécurité LTS restreintes, mais contient toujours OpenJDK 17. La commande est la même que sous Debian 12 :

apt install openjdk-17-jre-headless -y

Prévoyez malgré tout une montée de version à moyen terme, afin de retrouver des mises à jour de sécurité régulières pour tous les paquets.

Erreurs fréquentes et solutions

« Unable to locate package openjdk-17-jre-headless » sous Debian 13 : ce n'est pas une erreur de votre installation. Debian 13 ne contient tout simplement plus ce paquet. Installez-y Java 17 via le dépôt Adoptium ou passez au Java 21 fourni d'origine.

Le même message sous Debian 12 : ici, la liste locale des paquets est obsolète ou incomplète. Exécutez apt update et vérifiez dans /etc/apt/sources.list que le dépôt principal de votre version de Debian y figure bien.

java -version annonce une autre version : une installation Java plus ancienne est encore enregistrée comme version par défaut sur le système. Définissez la version souhaitée avec update-alternatives --config java.

Les tutoriels qui utilisent apt-key : les articles plus anciens ajoutent les dépôts tiers via apt-key adv. Cette commande est considérée comme obsolète depuis Debian 11, car une clé enregistrée de cette façon devient valable pour l'ensemble des dépôts du système. Les guides actuels placent la clé dans /etc/apt/keyrings/ et y renvoient dans la ligne sources grâce à signed-by=.

Votre application ne démarre pas malgré Java 17 : certains logiciels vérifient la version de Java au démarrage et exigent une version majeure précise. Dans ce cas, jetez un œil au fichier journal de l'application : la version exactement requise y est généralement indiquée.