Instalar o Java 21 no Debian 13 e no Debian 12

Pretende instalar o Java 21 no seu servidor Debian 13 (Trixie) ou Debian 12 (Bookworm)? O Java 21 é a versão LTS atual, com um longo período de atualizações, e a escolha certa para a maioria dos projetos novos. Este guia mostra três formas de o instalar.

Requisitos

Precisa de um acesso SSH com direitos de root (ou de um utilizador com permissão sudo) num Debian atual. Recomendam-se o Debian 13 "Trixie" e o Debian 12 "Bookworm". O Debian 10 chegou ao fim do suporte em junho de 2024 e já não recebe atualizações de segurança regulares, pelo que deixou de ser adequado para utilização produtiva.

Atualize primeiro a lista de pacotes do seu sistema Debian e aplique as atualizações disponíveis:

apt update && apt upgrade -y

Que versão do Java traz cada Debian?

O Debian troca as versões do OpenJDK incluídas a cada versão principal. Para o Java 21 isso significa o seguinte: só o Debian 13 o tem no repositório padrão, as versões mais antigas do Debian não. Esta tabela mostra o que está realmente nas fontes de pacotes oficiais (situação em julho de 2026):

Pode verificar por si próprio, a qualquer momento, se um pacote está disponível no seu sistema:

apt-cache policy openjdk-21-jre-headless

Se em "Candidato" aparecer um número de versão, pode instalar diretamente. Se surgir aí (nenhum), use o caminho do Temurin descrito duas secções mais abaixo.

Instalar o Java 21 no Debian 13 a partir do repositório

O Debian 13 já traz o OpenJDK 21. Este é o caminho mais simples e com menos manutenção, porque as atualizações de segurança chegam automaticamente através do apt upgrade:

apt install openjdk-21-jre-headless -y

A variante jre-headless contém apenas o ambiente de execução, sem bibliotecas gráficas, e é por isso a opção leve e adequada para um servidor. Se precisar também de um compilador, instale em vez disso o openjdk-21-jdk.

Em alternativa, obtém o mesmo resultado através do metapacote default-jre-headless, porque no Debian 13 ele resolve exatamente para o Java 21. No Debian 12, esse mesmo metapacote dá Java 17 e no Debian 11 dá Java 11.

apt install default-jre-headless -y

Se a sua aplicação não exigir uma versão principal fixa, este é o caminho com menos manutenção, porque não tem de acompanhar o número da versão dentro do nome do pacote.

Instalar o Java 21 no Debian 12 através do repositório Adoptium

O Debian 12 não inclui o OpenJDK 21 na fonte principal. Através do repositório Adoptium instala o Eclipse Temurin 21, uma build livre do OpenJDK que também é atualizada via apt.

Configure primeiro a fonte de pacotes:

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

De seguida instala o Java 21:

apt install temurin-21-jre -y

O repositório Adoptium disponibiliza as versões 8 a 26 para o Debian 13 e a mesma fonte de pacotes está igualmente disponível para o Debian 12. Se precisar de um compilador, use o temurin-21-jdk. A chave de assinatura fica aqui como ficheiro próprio em /etc/apt/keyrings/ e é atribuída exatamente a este repositório na linha de sources, através de signed-by=. O antigo comando apt-key está descontinuado desde o Debian 11 e não deve continuar a ser usado.

Alternativa: instalar o Oracle JDK 21 como pacote

Se precisar mesmo do Oracle JDK, descarregue o pacote diretamente e instale-o com o dpkg:

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

dpkg -i jdk-21_linux-x64_bin.deb

Tenha dois pontos em conta: o pacote não recebe atualizações através do apt, por isso tem de acompanhar as novas versões por si próprio. Além disso, o Oracle JDK tem condições de licença próprias, que deve verificar antes da utilização produtiva. O OpenJDK e o Eclipse Temurin, pelo contrário, estão sob uma licença aberta.

Verificar a instalação

Confirme no final se a instalação foi bem sucedida. Para isso, consulte a versão do Java instalada:

java -version

Se a saída contiver o número de versão 21, o Java 21 está corretamente configurado.

Definir a versão predefinida do Java

Se o java -version mostrar outra versão, continua definido um JDK mais antigo como predefinido. Liste primeiro todas as versões do Java instaladas:

update-alternatives --list java

Depois escolhe a versão pretendida de forma interativa a partir da lista:

update-alternatives --config java

De seguida verifique novamente com java -version se está agora ativa a versão correta.

Erros frequentes e respetivas soluções

"Unable to locate package openjdk-21-jre-headless": no Debian 12 e no Debian 11 isto não é uma falha da sua instalação, porque aí as fontes de pacotes não contêm o OpenJDK 21. Nesse caso, use o repositório Adoptium descrito na secção sobre o Debian 12.

dpkg comunica dependências em falta: execute a seguir apt install -f, para que os pacotes em falta sejam instalados automaticamente.

java -version mostra uma versão antiga apesar da instalação: defina a versão predefinida com update-alternatives --config java.

Que versão usar em projetos novos? O Java 21 é uma versão LTS e recebe atualizações de segurança durante muitos anos. Para aplicações novas é, por isso, normalmente a melhor escolha face ao Java 17 ou a versões mais antigas.