Tools & Add-onsPVE Tools
pve8-upgrade
Upgrade a Proxmox VE 7.4 host to Proxmox VE 8 by switching the APT sources to Debian 12 and running a dist-upgrade.
pve8-upgrade.sh is a legacy helper for the step from Proxmox VE 7.4 to 8. It is not listed on the website. There is no matching helper for 8 to 9 in tools/pve/.
Source: tools/pve/pve8-upgrade.sh.
Run
In the Proxmox VE host shell, as root:
bash -c "$(curl -fsSL https://raw.githubusercontent.com/community-scripts/ProxmoxVE/main/tools/pve/pve8-upgrade.sh)"Requirements checked by the script
| Check | Result if not met |
|---|---|
pveversion exists | "No PVE Detected!", exit |
Architecture is not arm64 | Exit 1 |
pveversion reports pve-manager/7.4-16, 7.4-17, 7.4-18 or 7.4-19 | "This version of Proxmox Virtual Environment is not supported", exit |
Prompts
There is one real question at the start, Start the Update to Proxmox VE 8 Script (y/n)?, and one at the end. Everything in between is a message box with only an OK button: the step runs as soon as you confirm the box. You cannot skip a single step.
| Step (box title) | What happens after OK |
|---|---|
| PVE8 SOURCES | Overwrites /etc/apt/sources.list with bookworm, bookworm-updates and bookworm-security (main contrib). |
| PVE8-ENTERPRISE | Overwrites /etc/apt/sources.list.d/pve-enterprise.list with the entry commented out. |
| PVE8-NO-SUBSCRIPTION | Writes /etc/apt/sources.list.d/pve-install-repo.list with the bookworm pve-no-subscription entry. |
| PVE8 CEPH PACKAGE REPOSITORIES | Writes /etc/apt/sources.list.d/ceph.list: ceph-quincy enterprise commented out, ceph-quincy no-subscription active. |
| PVE8 TEST | Writes /etc/apt/sources.list.d/pvetest-for-beta.list with the pvetest entry commented out. |
| PVE8 UPDATE | apt-get update, then DEBIAN_FRONTEND=noninteractive apt-get -o Dpkg::Options::="--force-confold" dist-upgrade -y. |
REBOOT (menu yes / no) | yes reboots the host. |
--force-confold keeps your existing configuration files where a package brings a new version.
Environment variables
| Variable | Default | Purpose |
|---|---|---|
COMMUNITY_SCRIPTS_CORE_URL | https://raw.githubusercontent.com/community-scripts/core/main | Base URL the script loads api/api.func from. |
Limits
- No undo and no backup of the replaced source files. A major-version upgrade cannot be rolled back by the script.
- The script runs no pre-upgrade checks beyond the three above. Work through Proxmox's own 7 to 8 upgrade checklist first.
- The Ceph no-subscription repository is enabled even on hosts that do not use Ceph.
- It does not touch the subscription notice or HA services. Use PVE Post Install on the upgraded host for that.
- In a cluster, upgrade node by node and follow Proxmox's upgrade notes.