Instalar o Java 17 no Ubuntu 24.04 e Ubuntu 22.04

Pretende instalar o Java 17 no seu servidor Ubuntu 24.04 LTS ou Ubuntu 22.04 LTS? O OpenJDK 17 está disponível em ambas as versões diretamente no repositório oficial do Ubuntu, pelo que hoje já não é necessário um PPA separado.

Pré-requisitos

Precisa de um acesso SSH com permissões de root (ou de um utilizador com autorização sudo) num Ubuntu atual. Recomendam-se o Ubuntu 24.04 LTS "Noble Numbat" e o Ubuntu 22.04 LTS "Jammy Jellyfish". O Ubuntu 20.04 LTS chegou ao fim do suporte regular em maio de 2025 e já não deve ser utilizado em produção.

Comece por atualizar a lista de pacotes do seu sistema Ubuntu e instale as atualizações disponíveis:

apt update && apt upgrade -y

Que versões de Java o Ubuntu disponibiliza?

O Ubuntu mantém todas as versões LTS habituais no repositório padrão, pelo que tem toda a liberdade na escolha da versão (dados de julho de 2026):

Esta é uma diferença clara face ao Debian, onde o OpenJDK 17 deixou de estar incluído a partir do Debian 13. Pode verificar a qualquer momento, e por si próprio, se um pacote está disponível no seu sistema:

apt-cache policy openjdk-17-jre-headless

Instalar o Java 17 no Ubuntu 24.04 e 22.04

O OpenJDK 17 faz parte das fontes de pacotes oficiais. Basta um único comando:

apt install openjdk-17-jre-headless -y

A variante jre-headless contém apenas o ambiente de execução, sem bibliotecas gráficas, sendo por isso a opção leve e adequada para um servidor, por exemplo para um servidor Minecraft ou uma aplicação web em Java.

Se precisar adicionalmente de um compilador, porque compila as aplicações diretamente no servidor, instale o JDK completo:

apt install openjdk-17-jdk -y

Verificar a instalação

Para terminar, confirme se a instalação foi bem-sucedida. Consulte para isso a versão de Java instalada:

java -version

Se a saída começar por openjdk version "17, o Java 17 está corretamente configurado e pronto a usar.

Alternativa: usar a versão predefinida do Ubuntu

Se a sua aplicação não exigir uma versão de Java específica, mas apenas um Java atual, o metapacote é o caminho mais cómodo. Instala automaticamente a versão que a sua distribuição define como padrão:

apt install default-jre-headless -y

Tenha em atenção: por esta via não obtém o Java 17 em nenhuma das duas versões. Se precisa expressamente do Java 17, mantenha-se no pacote openjdk-17-jre-headless.

Definir a variável JAVA_HOME

Muitas aplicações Java e sistemas de build esperam a variável de ambiente JAVA_HOME. No Ubuntu, o OpenJDK 17 fica normalmente num diretório próprio dentro de /usr/lib/jvm/. O caminho exato determina-se assim:

update-alternatives --list java

De seguida, registe o caminho de forma permanente em /etc/environment:

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

Após um novo início de sessão por SSH, a variável fica disponível em todo o sistema.

Gerir várias versões de Java em paralelo

Se estiverem instalados vários JDK, é a gestão de alternatives que decide qual a versão que arranca ao invocar java. A versão predefinida pretendida escolhe-se de forma interativa:

update-alternatives --config java

Alternativa: Eclipse Temurin através do repositório Adoptium

Se precisa de um build concreto do Java 17 que receba atualizações mais depressa do que o pacote da distribuição, o Eclipse Temurin é uma boa opção. Configure para isso o repositório Adoptium:

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

apt install temurin-17-jre -y

Para o Ubuntu 24.04, o repositório Adoptium disponibiliza as versões 8 até 26 e, para o Ubuntu 22.04, está disponível a mesma fonte de pacotes. Se precisar de um compilador, use temurin-17-jdk. Aqui a chave de assinatura fica num ficheiro próprio em /etc/apt/keyrings/ e é associada, através de signed-by=, exatamente a este único repositório. O antigo comando apt-key está descontinuado, porque uma chave assim registada seria válida para todas as fontes de pacotes do sistema.

Erros frequentes e respetivas soluções

Tutoriais com ppa:linuxuprising/java ou oracle-java17-installer: este método vem de uma altura em que o OpenJDK 17 ainda não constava das fontes de pacotes do Ubuntu. No Ubuntu 24.04 e 22.04 é dispensável, sendo o pacote oficial openjdk-17-jre-headless a melhor escolha.

"Unable to locate package openjdk-17-jre-headless": a lista de pacotes local está desatualizada. Execute apt update e tente novamente.

java -version mostra outra versão: no sistema continua definida como padrão uma instalação de Java mais antiga. Corrija isso com update-alternatives --config java.

A sua aplicação não arranca apesar do Java 17: alguns programas verificam a versão de Java no arranque e exigem uma versão principal específica. O ficheiro de log da aplicação indica, por norma, a versão exigida.