- ";var n = 0;$content.find("div.sect1").each(function(){ var h = jQuery(this).find("h2").first(); var id = h.attr("id"); if (id != null) {n++;html += "
- " + "" + "" + h.html() + " "; }});html += "
";if (n > 3) { tocholder.html(html); tocholder.show();} }, // footnote generator footnotes: function ($content) {var noteholder = $content.find('#footnotes');if (!noteholder) { return;}noteholder.html('');// Rebuild footnote entries.var refs = {};var n = 0;var inner_html = '';$content.find("span.footnote").each(function(){ n++; var span = jQuery(this); var note = span.attr("data-note"); var id = span.attr("id"); if (!note) {// Use [\s\S] in place of . so multi-line matches work.// Because JavaScript has no s (dotall) regex flag.note = span.html().match(/\s*\[([\s\S]*)]\s*/)[1];span.html("[" + n + "]");span.attr("data-note", note); } inner_html += "
" +"" +n + ". " + note + "
"; if (id != null) { refs["#"+id] = n; }});if (inner_html) { noteholder.html("
" + inner_html); }if (n != 0) { // process footnoterefs. $content.find("span.footnoteref").each(function(){var span = jQuery(this);var href = span.find("a").first().attr("href");href = href.match(/#.*/)[0]; // in case it return full URL.n = refs[href];span.html("[" + n + "]"); });} }};// add init to mediawiki resource loader queue(window.RLQ=window.RLQ||[]).push(function(){ // cannot use mw.hook directly here yet, the mediawiki.base module is not yet available mw.loader.implement('pve.doctoc', function() {mw.hook('wikipage.content').add(function($content) { asciidoc.toc($content); asciidoc.footnotes($content);}); });});
Proxmox VE uses APT as itspackage management tool like any other Debian-based system.
Proxmox VE automatically checks for package updates on a daily basis. The root@pamuser is notified via email about available updates. From the GUI, theChangelog button can be used to see more details about an selected update.
Repositories in Proxmox VE
Repositories are a collection of software packages, they can be used to installnew software, but are also important to get new updates.
You need valid Debian and Proxmox repositories to get the latestsecurity updates, bug fixes and new features. |
APT Repositories are defined in the file /etc/apt/sources.list and in .listfiles placed in /etc/apt/sources.list.d/.
Repository Management
Since Proxmox VE 7, you can check the repository state in the web interface.The node summary panel shows a high level status overview, while the separateRepository panel shows in-depth status and list of all configuredrepositories.
Basic repository management, for example, activating or deactivating arepository, is also supported.
Sources.list
In a sources.list file, each line defines a package repository. The preferredsource must come first. Empty lines are ignored. A # character anywhere on aline marks the remainder of that line as a comment. The available packages froma repository are acquired by running apt-get update. Updates can be installeddirectly using apt-get, or via the GUI (Node → Updates).
File
/etc/apt/sources.listdeb http://deb.debian.org/debian bookworm main contribdeb http://deb.debian.org/debian bookworm-updates main contrib# security updatesdeb http://security.debian.org/debian-security bookworm-security main contrib
Proxmox VE provides three different package repositories.
Proxmox VE Enterprise Repository
This is the recommended repository and available for all Proxmox VE subscriptionusers. It contains the most stable packages and is suitable for production use.The pve-enterprise repository is enabled by default:
File
/etc/apt/sources.list.d/pve-enterprise.listdeb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise
Please note that you need a valid subscription key to access thepve-enterprise repository. We offer different support levels, which you canfind further details about at https://proxmox.com/en/proxmox-virtual-environment/pricing.
You can disable this repository by commenting out the above line using a# (at the start of the line). This prevents error messages if your host doesnot have a subscription key. Please configure the pve-no-subscriptionrepository in that case. |
Proxmox VE No-Subscription Repository
As the name suggests, you do not need a subscription key to accessthis repository. It can be used for testing and non-productionuse. It’s not recommended to use this on production servers, as thesepackages are not always as heavily tested and validated.
We recommend to configure this repository in /etc/apt/sources.list.
File
/etc/apt/sources.listdeb http://ftp.debian.org/debian bookworm main contribdeb http://ftp.debian.org/debian bookworm-updates main contrib# Proxmox VE pve-no-subscription repository provided by proxmox.com,# NOT recommended for production usedeb http://download.proxmox.com/debian/pve bookworm pve-no-subscription# security updatesdeb http://security.debian.org/debian-security bookworm-security main contrib
Proxmox VE Test Repository
This repository contains the latest packages and is primarily used by developersto test new features. To configure it, add the following line to/etc/apt/sources.list:
sources.list entry for
pvetestdeb http://download.proxmox.com/debian/pve bookworm pvetest
The pvetest repository should (as the name implies) only be used fortesting new features or bug fixes. |
Ceph Reef Enterprise Repository
This repository holds the enterprise Proxmox VE Ceph 18.2 Reef packages. They aresuitable for production. Use this repository if you run the Ceph client or afull Ceph cluster on Proxmox VE.
File
/etc/apt/sources.list.d/ceph.listdeb https://enterprise.proxmox.com/debian/ceph-reef bookworm enterprise
Ceph Reef No-Subscription Repository
This Ceph repository contains the Ceph 18.2 Reef packages before they are movedto the enterprise repository and after they where on the test repository.
It’s recommended to use the enterprise repository for productionmachines. |
File
/etc/apt/sources.list.d/ceph.listdeb http://download.proxmox.com/debian/ceph-reef bookworm no-subscription
Ceph Reef Test Repository
This Ceph repository contains the Ceph 18.2 Reef packages before they are movedto the main repository. It is used to test new Ceph releases on Proxmox VE.
File
/etc/apt/sources.list.d/ceph.listdeb http://download.proxmox.com/debian/ceph-reef bookworm test
Ceph Quincy Enterprise Repository
This repository holds the enterprise Proxmox VE Ceph Quincy packages. They aresuitable for production. Use this repository if you run the Ceph client or afull Ceph cluster on Proxmox VE.
File
/etc/apt/sources.list.d/ceph.listdeb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise
Ceph Quincy No-Subscription Repository
This Ceph repository contains the Ceph Quincy packages before they are movedto the enterprise repository and after they where on the test repository.
It’s recommended to use the enterprise repository for productionmachines. |
File
/etc/apt/sources.list.d/ceph.listdeb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription
Ceph Quincy Test Repository
This Ceph repository contains the Ceph Quincy packages before they are movedto the main repository. It is used to test new Ceph releases on Proxmox VE.
File
/etc/apt/sources.list.d/ceph.listdeb http://download.proxmox.com/debian/ceph-quincy bookworm test
Older Ceph Repositories
Proxmox VE 8 doesn’t support Ceph Pacific, Ceph Octopus, or even older releases forhyper-converged setups. For those releases, you need to first upgrade Ceph to anewer release before upgrading to Proxmox VE 8.
See the respectiveupgrade guide for details.
Debian Firmware Repository
Starting with Debian Bookworm (Proxmox VE 8) non-free firmware (as defined byDFSG) has been moved to thenewly created Debian repository component non-free-firmware.
Enable this repository if you want to set upEarly OS Microcode Updates or need additionalRuntime Firmware Files not alreadyincluded in the pre-installed package pve-firmware.
To be able to install packages from this component, runeditor /etc/apt/sources.list, append non-free-firmware to the end of each.debian.org repository line and run apt update.
SecureApt
The Release files in the repositories are signed with GnuPG. APT is usingthese signatures to verify that all packages are from a trusted source.
If you install Proxmox VE from an official ISO image, the key for verification isalready installed.
If you install Proxmox VE on top of Debian, download and installthe key with the following commands:
# wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
Verify the checksum afterwards with the sha512sum CLI tool:
# sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87 /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
or the md5sum CLI tool:
# md5sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg41558dc019ef90bd0f6067644a51cf5b /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
Proxmox VE 7.x Repositories
Proxmox VE 7.x is based on Debian 11.x (“bullseye”). Please note that this releaseis out of date (see the FAQ support table). Existinginstallations should be updated. Nevertheless access to these repositories isstill provided.
Repository | sources.list entry |
---|---|
Proxmox VE 7.x Enterprise | deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise |
Proxmox VE 7.x No-Subscription | deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription |
Proxmox VE 7.x Test | deb http://download.proxmox.com/debian/pve bullseye pvetest |
Release key URL: https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg
Release key hash sums:
sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfamd5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpgbcc35c7173e0845c0d6ad6470b70f50e
Proxmox VE 6.x Repositories
Proxmox VE 6.x is based on Debian 10.x (“buster”). Please note that this release isout of date. Existing installations should be updated. Nevertheless access tothese repositories is still provided.
Repository | sources.list entry |
---|---|
Proxmox VE 6.x Enterprise | deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise |
Proxmox VE 6.x No-Subscription | deb http://download.proxmox.com/debian/pve buster pve-no-subscription |
Proxmox VE 6.x Test | deb http://download.proxmox.com/debian/pve buster pvetest |
Proxmox VE 5.x Repositories
Proxmox VE 5.x is based on Debian 9.x (“stretch”). Please note that this release isout of date. Existing installations should be updated. Nevertheless access tothese repositories is still provided.
Repository | sources.list entry |
---|---|
Proxmox VE 5.x Enterprise | deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise |
Proxmox VE 5.x No-Subscription | deb http://download.proxmox.com/debian/pve stretch pve-no-subscription |
Proxmox VE 5.x Test | deb http://download.proxmox.com/debian/pve stretch pvetest |
Proxmox VE 4.x Repositories
Proxmox VE 4.x is based on Debian 8.x (“jessie”). Please note that this release isout of date. Existing installations should be updated. Nevertheless access tothese repositories is still provided.
Repository | sources.list entry |
---|---|
Proxmox VE 4.x Enterprise | deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise |
Proxmox VE 4.x No-Subscription | deb http://download.proxmox.com/debian/pve jessie pve-no-subscription |
Proxmox VE 4.x Test | deb http://download.proxmox.com/debian/pve jessie pvetest |
Proxmox VE 3.x Repositories
Proxmox VE 3.x is based on Debian 7.x (“wheezy”). Please note that this release isout of date. Existing installations should be updated. Nevertheless access tothese repositories is still provided.
Repository | sources.list entry |
---|---|
Proxmox VE 3.x Enterprise | deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise |
Proxmox VE 3.x No-Subscription | deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription |
Proxmox VE 3.x Test | deb http://download.proxmox.com/debian/pve wheezy pvetest |
Outdated: stable Repository pve
This repository is a leftover to ease the update to 3.1. It will not get anyupdates after the release of 3.1. Therefore the repository needs to be removedafter the upgrade to 3.1.
File
/etc/apt/sources.listdeb http://ftp.debian.org/debian wheezy main contrib# PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1# deb http://download.proxmox.com/debian wheezy pve# security updatesdeb http://security.debian.org/ wheezy/updates main contrib
Outdated: Proxmox VE 2.x Repositories
Proxmox VE 2.x is based on Debian 6.0 (“squeeze”) and outdated. Please upgrade tothe latest version as soon as possible. In order to use the stable pve 2.xrepository, check your sources.list:
File
/etc/apt/sources.listdeb http://ftp.debian.org/debian squeeze main contrib# PVE packages provided by proxmox.comdeb http://download.proxmox.com/debian squeeze pve# security updatesdeb http://security.debian.org/ squeeze/updates main contrib
Outdated: Proxmox VE VE 1.x Repositories
Proxmox VE 1.x is based on Debian 5.0 (“lenny”) and very outdated. Please upgradeto latest version as soon as possible.