Veja como instalar Proxmox no Debian 12

O Proxmox Virtual En­vi­ron­ment (Proxmox VE) facilita a gestão de máquinas virtuais e con­tai­ners em ser­vi­do­res Linux. Neste guia, você vê passo a posso como instalar e con­fi­gu­rar o Proxmox no Debian 12 (Bookworm).

Passo 1: preparar o servidor

Antes de começar a instalar o Proxmox no Debian, você vai precisar de um servidor com recursos su­fi­ci­en­tes para rodar o ambiente sem travar. Para um ambiente típico de teste ou produção, o ideal é ter pelo menos um pro­ces­sa­dor Quad-Core, 8 GB de RAM e 100 GB de espaço em disco.

Confira se o Debian 12 já está instalado cor­re­ta­mente e com acesso à Internet. Depois disso, atualize os pacotes para deixar o sistema em dia e pronto para a ins­ta­la­ção do Proxmox.

sudo apt update && sudo apt upgrade -y
sudo reboot

Passo 2: adicionar o re­po­si­tó­rio do Proxmox

O Proxmox não faz parte dos re­po­si­tó­rios padrão do Debian, então pre­ci­sa­mos adicioná-lo ma­nu­al­mente. Primeiro, importe a chave GPG:

sudo wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg

Depois, adicione o re­po­si­tó­rio “no-subs­crip­tion”:

echo "deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription" | sudo tee /etc/apt/sources.list.d/pve-install-repo.list

Agora atualize a lista de pacotes para ativar o novo re­po­si­tó­rio:

sudo apt update

Passo 3: instalar o kernel do Proxmox

Antes de instalar o próprio Proxmox VE, é preciso con­fi­gu­rar primero o kernel do Proxmox. Esse kernel foi de­sen­vol­vido es­pe­ci­al­mente para cenários de vir­tu­a­li­za­ção e oferece melhor de­sem­pe­nho e com­pa­ti­bi­li­dade com o Proxmox VE. Para instalar o kernel, use os comandos abaixo:

sudo apt install proxmox-default-kernel -y
sudo reboot

Passo 4: instalar o Proxmox

Agora começa a ins­ta­la­ção do Proxmox no Debian. O comando a seguir baixa todos os pacotes ne­ces­sá­rios e já configura o Proxmox V au­to­ma­ti­ca­mente:

sudo apt install proxmox-ve postfix open-iscsi -y

O ins­ta­la­dor pode pedir para você con­fi­gu­rar o Postfix. Se isso acontecer, escolhe “Internet Site” e insira o nome do host. Depois, reinicie o servidor:

sudo reboot

Passo 5: remover kernels antigos do Debian

Depois de instalar o Proxmox, o sistema passa a usar o kernel especial do Proxmox, baseado na versão atual do Debian e otimizado para vir­tu­a­li­za­ção. O Debian 12, porém, também instala seu próprio kernel por padrão: nor­mal­mente o pacote linux-image-amd64. Para evitar entradas du­pli­ca­das no menu de boot e possíveis conflitos, remova o kernel padrão do Debian. Isso deixa o sistema mais limpo e reduz possíveis fontes de erro nas próximas atu­a­li­za­ções.

Execute os comandos abaixo:

sudo apt remove linux-image-amd64 linux-image-6.1* -y
sudo update-grub

O primeiro comando remove os kernels antigos do Debian que já não são mais ne­ces­sá­rios. O segundo atualiza o bo­o­tlo­a­der para que o sistema use apenas o kernel do Proxmox.

Reinicie o servidor para garantir que o novo kernel seja carregado cor­re­ta­mente:

sudo reboot

Depois do reinício, confira qual kernel está ativo:

uname -r

A saída deve ser parecida com 6.8.4-3-pve. Se aparecer nesse formato, significa que o sistema já está usando o kernel do Proxmox.

Passo 6: acessar a interface web do Proxmox

O Proxmox agora está com­ple­ta­mente instalado e pronto para usar. Toda a ad­mi­nis­tra­ção do sistema é feita pela interface web, que você pode acessar de qualquer navegador. Abra o navegador de sua pre­fe­rên­cia e digite na barra de endereço o IP do servidor com a porta padrão 8006, sempre usando HTTPS, já que a conexão vem crip­to­gra­fada por padrão:

https://<SEU-ENDEREÇO-DE-IP>:8006/

No primeiro acesso, o navegador pode exibir um aviso dizendo que o cer­ti­fi­cado SSL não é confiável. Isso é normal, porque o Proxmox usa um cer­ti­fi­cado au­to­as­si­nado. Basta confirmar o aviso para continuar. Depois disso, a página de login do Proxmox VE será exibida. Entre com o usuário “root” e a senha do seu sistema Debian. O campo Realm deve aparecer como Linux PAM standard authentication. Deixe essa opção como está.

Após o login, você verá o dashboard do Proxmox. Ele dá acesso a todas as fer­ra­men­tas de ge­ren­ci­a­mento, como:

• criação e ad­mi­nis­tra­ção de máquinas virtuais e con­tai­ners
• con­fi­gu­ra­ção de ar­ma­ze­na­mento e redes
• mo­ni­to­ra­mento de CPU, RAM e uso de disco

Com isso, a ins­ta­la­ção está concluída e você já pode começar a con­fi­gu­rar sua primeira máquina ou ambiente virtual.

Passo 7: ajustar re­po­si­tó­rios e remover alertas

Após a ins­ta­la­ção e o primeiro login na interface web, o Proxmox exibe um aviso in­for­mando que não há uma as­si­na­tura ativa. Isso acontece porque o sistema tenta usar o re­po­si­tó­rio En­ter­prise, que requer uma licença válida de suporte. Como estamos usando o re­po­si­tó­rio No-Subs­crip­tion, que é de acesso livre, você pode remover o aviso e desativar a entrada do re­po­si­tó­rio En­ter­prise com o comando abaixo:

sudo sed -i 's/^deb/#deb/' /etc/apt/sources.list.d/pve-enterprise.list

Esse comando comenta a linha do re­po­si­tó­rio no arquivo de con­fi­gu­ra­ção, que passa a ser ignorada nas próximas atu­a­li­za­ções de pacotes. Em seguida, atualize a lista de pacotes para que o sistema adote a mudança:

sudo apt update

Essa alteração não afeta a es­ta­bi­li­dade do sistema. Ela apenas remove o aviso de as­si­na­tura e garante que, a partir de agora, todas as atu­a­li­za­ções venham somente do re­po­si­tó­rio No-Subs­crip­tion já con­fi­gu­rado.

Passo 8: atualizar o sistema e fazer uma ve­ri­fi­ca­ção final

Para concluir a ins­ta­la­ção, confira se o sistema está to­tal­mente atu­a­li­zado e se todos os serviços do Proxmox estão fun­ci­o­nando cor­re­ta­mente. Isso ajuda a evitar problemas de com­pa­ti­bi­li­dade e garante que o ambiente opere de forma estável. Atualize todos os pacotes ins­ta­la­dos com o seguinte comando:

sudo apt full-upgrade -y

Depois da atu­a­li­za­ção, vale conferir o status dos prin­ci­pais serviços do Proxmox. Esses serviços garantem que a interface de ge­ren­ci­a­mento e as funções de vir­tu­a­li­za­ção funcionem sem problemas:

sudo systemctl status pve-cluster
sudo systemctl status pvedaemon
sudo systemctl status pveproxy

Se todos apa­re­ce­rem como active (running), sua ins­ta­la­ção do Proxmox Debian está fun­ci­o­nando como esperado. Com isso, a con­fi­gu­ra­ção está concluída e seu servidor está pronto para uso em produção. Você já pode criar máquinas virtuais e con­tai­ners pela interface web, con­fi­gu­rar redes e gerenciar o ar­ma­ze­na­mento.

Quando o ambiente estiver pronto, você pode expandir o Proxmox com bastante fle­xi­bi­li­dade. Por exemplo, in­te­grando um servidor de arquivos do Proxmox para acesso cen­tra­li­zado ao ar­ma­ze­na­mento ou um Proxmox Backup Server para proteger suas máquinas virtuais e con­tai­ners.