docs/Workflows/Linux/ProxmoxVE/Upgrade PVE from 8 to 9.md

Purpose

There are a few steps you have to take when upgrading ProxmoxVE from 8.4.1+ to 9.0+. The process is fairly straightforward, so just follow the instructions seen below.

!!! info "GuestVM Assumptions" It is assumed that if you are running a ProxmoxVE cluster, you will migrate all GuestVMs to another cluster node. If this is a standalone ProxmoxVE server, you will shut down all GuestVMs safely before proceeding.

!!! warning "Perform pve8to9 Readiness Check" It's critical that you run the pve8to9 command to ensure that your ProxmoxVE server meets all of the requirements and doesn't have any failures or potentially server-breaking warnings. If the pve8to9 command is unknown, then run apt update && apt dist-upgrade in the shell then try again. Warnings should be addressed ad-hoc, but CPU Microcode warnings can be safely ignored.

**Example pve8to9 Summary Output**:
```sh
= SUMMARY =

TOTAL:    48
PASSED:   39
SKIPPED:  8
WARNINGS: 1
FAILURES: 0
```

Update Repositories from bookworm to trixie

sed -i 's/bookworm/trixie/g' /etc/apt/sources.list
sed -i 's/bookworm/trixie/g' /etc/apt/sources.list.d/pve-install-repo.list
apt update

Upgrade to ProxmoxVE 9.0

!!! warning "Run Upgrade Commands in iLO/iDRAC/IPMI" At this point, its very likely that if you are using SSH, it may unexpectedly have the session terminated, so you absolutely want to use a local or remote console to the server to run the commands below, both to ensure you maintain access to the console, as well as to see if any issues arise during POST after the reboot.

apt dist-upgrade -y
reboot

!!! note "Disable pve-enterprise Repository" At this point, the ProxmoxVE server should be running on v9.0+, you will want to disable the pve-enterprise repository as it will goof up future updates if you don't disable it.