====== 🚀 Upgrade Proxmox VE 8 → 9 (No-Subscription) ======

===== 📋 Visão Geral =====

Procedimento de atualização **in-place** do **Proxmox VE 8.4.x para Proxmox VE 9.x** utilizando repositórios **No-Subscription**.

  * **Tempo estimado:** 15–45 min
  * **Downtime:** Sim (reinicialização obrigatória)
  * **Recomendado:** Executar em janela de manutenção

-----

===== ⚠️ Pré-Requisitos =====

Antes do upgrade:

  * Host executando **Proxmox VE 8.4.x totalmente atualizado**
  * Backup das VMs/LXCs
  * Backup da configuração do host
  * Validar espaço livre em disco (**recomendado ≥ 5 GB livres**)
  * Snapshot/backup adicional recomendado

Backup rápido das configurações:

<code bash>
mkdir -p /root/backup-pre-pve9

cp /etc/network/interfaces /root/backup-pre-pve9/
cp -r /etc/pve /root/backup-pre-pve9/
cp /etc/hosts /root/backup-pre-pve9/
</code>

Verificar espaço disponível:

<code bash>
df -h
</code>

-----

===== 1. Atualizar totalmente o Proxmox VE 8 =====

Garantir que o host esteja totalmente atualizado na última versão do PVE 8.

<code bash>
apt update
apt full-upgrade -y
reboot
</code>

Validar versão atual:

<code bash>
pveversion
</code>

Confirmar que está em **PVE 8.4.x atualizado**.

-----

===== 2. Executar verificação pré-upgrade =====

Rodar o checker oficial:

<code bash>
pve8to9 --full
</code>

Analisar cuidadosamente o resultado.

**IMPORTANTE**

  * Corrigir todos os **ERRORS**
  * Revisar todos os **WARNINGS**
  * Não prosseguir com pendências críticas

-----

===== 3. Ajustar repositórios Debian 13 (Trixie) =====

Atualizar referências **Bookworm → Trixie**.

Editar o sources principal:

<code bash>
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
</code>

Revisar repositórios adicionais:

<code bash>
grep -R bookworm /etc/apt/sources.list*
</code>

Caso existam entradas restantes apontando para **Bookworm**, ajustar manualmente.

Desabilitar repositório Enterprise (caso exista):

<code bash>
rm -f /etc/apt/sources.list.d/pve-enterprise.list
</code>

-----

===== 4. Configurar repositório Proxmox No-Subscription =====

Criar o repositório oficial PVE9:

<code bash>
cat > /etc/apt/sources.list.d/proxmox.sources <<EOF
Types: deb
URIs: http://download.proxmox.com/debian/pve
Suites: trixie
Components: pve-no-subscription
Signed-By: /usr/share/keyrings/proxmox-archive-keyring.gpg
EOF
</code>

-----

===== 5. Atualizar índices APT =====

<code bash>
apt update
</code>

Validar:

  * Sem erros de assinatura
  * Sem erros de repositório
  * Sem pacotes quebrados

Opcionalmente validar pacotes pendentes:

<code bash>
apt list --upgradable
</code>

-----

===== 6. Executar Upgrade para Proxmox VE 9 =====

Executar atualização completa:

<code bash>
apt full-upgrade
</code>

Durante o processo, revisar prompts de configuração.

Arquivos comuns:

  * ''sshd_config''
  * ''grub''
  * ''interfaces''
  * Configurações customizadas

Caso utilize customizações próprias, revisar antes de aceitar overwrite.

-----

===== 7. Reinicializar o host =====

Após conclusão:

<code bash>
reboot
</code>

-----

===== 8. Validação Pós-Upgrade =====

Confirmar versão:

<code bash>
pveversion
</code>

Verificar kernel:

<code bash>
uname -a
</code>

Validar serviços:

<code bash>
systemctl status pveproxy
systemctl status pvedaemon
systemctl status pve-cluster
</code>

Validar funcionamento:

  * GUI Web (porta 8006)
  * VMs
  * Containers
  * Storages
  * Backups
  * Rede

-----

===== 🔎 Troubleshooting =====

==== Atualização interrompida ====

<code bash>
apt --fix-broken install
dpkg --configure -a
</code>

Depois repetir:

<code bash>
apt full-upgrade
</code>

----

==== Verificar pacotes pendentes ====

<code bash>
apt list --upgradable
</code>

----

==== Verificar repositórios ativos =====

<code bash>
grep -R . /etc/apt/sources.list*
</code>

-----

===== 🔗 Referência Oficial =====

https://pve.proxmox.com/wiki/Upgrade_from_8_to_9