1 [[sysadmin_package_repositories]]
8 {pve} uses http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as its
9 package management tool like any other Debian-based system.
11 {pve} automatically checks for package updates on a daily basis. The `root@pam`
12 user is notified via email about available updates. From the GUI, the
13 'Changelog' button can be used to see more details about an selected update.
18 Repositories are a collection of software packages, they can be used to install
19 new software, but are also important to get new updates.
21 NOTE: You need valid Debian and Proxmox repositories to get the latest
22 security updates, bug fixes and new features.
24 APT Repositories are defined in the file `/etc/apt/sources.list` and in `.list`
25 files placed in `/etc/apt/sources.list.d/`.
30 [thumbnail="screenshot/gui-node-repositories.png"]
32 Since Proxmox VE 7, you can check the repository state in the web interface.
33 The node summary panel shows a high level status overview, while the separate
34 'Repository' panel shows in-depth status and list of all configured
37 Basic repository management, for example, activating or deactivating a
38 repository, is also supported.
43 In a `sources.list` file, each line defines a package repository. The preferred
44 source must come first. Empty lines are ignored. A `#` character anywhere on a
45 line marks the remainder of that line as a comment. The available packages from
46 a repository are acquired by running `apt-get update`. Updates can be installed
47 directly using `apt-get`, or via the GUI (Node -> Updates).
49 .File `/etc/apt/sources.list`
51 deb http://deb.debian.org/debian bookworm main contrib
52 deb http://deb.debian.org/debian bookworm-updates main contrib
55 deb http://security.debian.org/debian-security bookworm-security main contrib
58 {pve} provides three different package repositories.
60 [[sysadmin_enterprise_repo]]
61 {pve} Enterprise Repository
62 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
64 This is the recommended repository and available for all {pve} subscription
65 users. It contains the most stable packages and is suitable for production use.
66 The `pve-enterprise` repository is enabled by default:
68 .File `/etc/apt/sources.list.d/pve-enterprise.list`
70 deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise
73 Please note that you need a valid subscription key to access the
74 `pve-enterprise` repository. We offer different support levels, which you can
75 find further details about at {pricing-url}.
77 NOTE: You can disable this repository by commenting out the above line using a
78 `#` (at the start of the line). This prevents error messages if your host does
79 not have a subscription key. Please configure the `pve-no-subscription`
80 repository in that case.
82 [[sysadmin_no_subscription_repo]]
83 {pve} No-Subscription Repository
84 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
86 As the name suggests, you do not need a subscription key to access
87 this repository. It can be used for testing and non-production
88 use. It's not recommended to use this on production servers, as these
89 packages are not always as heavily tested and validated.
91 We recommend to configure this repository in `/etc/apt/sources.list`.
93 .File `/etc/apt/sources.list`
95 deb http://ftp.debian.org/debian bookworm main contrib
96 deb http://ftp.debian.org/debian bookworm-updates main contrib
98 # Proxmox VE pve-no-subscription repository provided by proxmox.com,
99 # NOT recommended for production use
100 deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
103 deb http://security.debian.org/debian-security bookworm-security main contrib
107 [[sysadmin_test_repo]]
108 {pve} Test Repository
109 ~~~~~~~~~~~~~~~~~~~~~~
111 This repository contains the latest packages and is primarily used by developers
112 to test new features. To configure it, add the following line to
113 `/etc/apt/sources.list`:
115 .sources.list entry for `pvetest`
117 deb http://download.proxmox.com/debian/pve bookworm pvetest
120 WARNING: The `pvetest` repository should (as the name implies) only be used for
121 testing new features or bug fixes.
123 [[sysadmin_package_repositories_ceph]]
124 Ceph Reef Enterprise Repository
125 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
127 This repository holds the enterprise {pve} Ceph 18.2 Reef packages. They are
128 suitable for production. Use this repository if you run the Ceph client or a
129 full Ceph cluster on {pve}.
131 .File `/etc/apt/sources.list.d/ceph.list`
133 deb https://enterprise.proxmox.com/debian/ceph-reef bookworm enterprise
137 Ceph Reef No-Subscription Repository
138 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
140 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
141 to the enterprise repository and after they where on the test repository.
143 NOTE: It's recommended to use the enterprise repository for production
146 .File `/etc/apt/sources.list.d/ceph.list`
148 deb http://download.proxmox.com/debian/ceph-reef bookworm no-subscription
152 Ceph Reef Test Repository
153 ~~~~~~~~~~~~~~~~~~~~~~~~~
155 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
156 to the main repository. It is used to test new Ceph releases on {pve}.
158 .File `/etc/apt/sources.list.d/ceph.list`
160 deb http://download.proxmox.com/debian/ceph-reef bookworm test
163 Ceph Quincy Enterprise Repository
164 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
166 This repository holds the enterprise {pve} Ceph Quincy packages. They are
167 suitable for production. Use this repository if you run the Ceph client or a
168 full Ceph cluster on {pve}.
170 .File `/etc/apt/sources.list.d/ceph.list`
172 deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise
176 Ceph Quincy No-Subscription Repository
177 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
179 This Ceph repository contains the Ceph Quincy packages before they are moved
180 to the enterprise repository and after they where on the test repository.
182 NOTE: It's recommended to use the enterprise repository for production
185 .File `/etc/apt/sources.list.d/ceph.list`
187 deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription
191 Ceph Quincy Test Repository
192 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
194 This Ceph repository contains the Ceph Quincy packages before they are moved
195 to the main repository. It is used to test new Ceph releases on {pve}.
197 .File `/etc/apt/sources.list.d/ceph.list`
199 deb http://download.proxmox.com/debian/ceph-quincy bookworm test
202 Older Ceph Repositories
203 ~~~~~~~~~~~~~~~~~~~~~~~
205 {pve} 8 doesn't support Ceph Pacific, Ceph Octopus, or even older releases for
206 hyper-converged setups. For those releases, you need to first upgrade Ceph to a
207 newer release before upgrading to Proxmox VE 8.
210 https://pve.proxmox.com/wiki/Category:Ceph_Upgrade[upgrade guide] for details.
213 [[sysadmin_debian_firmware_repo]]
214 Debian Firmware Repository
215 ~~~~~~~~~~~~~~~~~~~~~~~~~~
217 Starting with Debian Bookworm ({pve} 8) non-free firmware (as defined by
218 https://www.debian.org/social_contract#guidelines[DFSG]) has been moved to the
219 newly created Debian repository component `non-free-firmware`.
221 Enable this repository if you want to set up
222 xref:sysadmin_firmware_cpu[Early OS Microcode Updates] or need additional
223 xref:sysadmin_firmware_runtime_files[Runtime Firmware Files] not already
224 included in the pre-installed package `pve-firmware`.
226 To be able to install packages from this component, run
227 `editor /etc/apt/sources.list`, append `non-free-firmware` to the end of each
228 `.debian.org` repository line and run `apt update`.
236 The 'Release' files in the repositories are signed with GnuPG. APT is using
237 these signatures to verify that all packages are from a trusted source.
239 If you install {pve} from an official ISO image, the key for verification is
242 If you install {pve} on top of Debian, download and install
243 the key with the following commands:
246 # wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
249 Verify the checksum afterwards with the `sha512sum` CLI tool:
252 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
253 7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87 /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
256 or the `md5sum` CLI tool:
259 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
260 41558dc019ef90bd0f6067644a51cf5b /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
266 // include note about older releases, but only for wiki
268 {pve} 7.x Repositories
269 ~~~~~~~~~~~~~~~~~~~~~~
271 {pve} 7.x is based on Debian 11.x (``bullseye''). Please note that this release
272 is out of date (see the xref:faq-support-table[FAQ support table]). Existing
273 installations should be updated. Nevertheless access to these repositories is
276 [width="100%",cols="<d,3m",options="header"]
277 |===========================================================
278 |Repository | sources.list entry
279 |{pve} 7.x Enterprise |
280 deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise
281 |{pve} 7.x No-Subscription |
282 deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
284 deb http://download.proxmox.com/debian/pve bullseye pvetest
285 |===========================================================
287 Release key URL: https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg
289 Release key hash sums:
292 sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
293 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa
295 md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
296 bcc35c7173e0845c0d6ad6470b70f50e
300 {pve} 6.x Repositories
301 ~~~~~~~~~~~~~~~~~~~~~~
303 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
304 out of date. Existing installations should be updated. Nevertheless access to
305 these repositories is still provided.
307 [width="100%",cols="<d,3m",options="header"]
308 |===========================================================
309 |Repository | sources.list entry
310 |{pve} 6.x Enterprise |
311 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
312 |{pve} 6.x No-Subscription |
313 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
315 deb http://download.proxmox.com/debian/pve buster pvetest
316 |===========================================================
319 {pve} 5.x Repositories
320 ~~~~~~~~~~~~~~~~~~~~~~
322 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
323 out of date. Existing installations should be updated. Nevertheless access to
324 these repositories is still provided.
326 [width="100%",cols="<d,3m",options="header"]
327 |===========================================================
328 |Repository | sources.list entry
329 |{pve} 5.x Enterprise |
330 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
331 |{pve} 5.x No-Subscription |
332 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
334 deb http://download.proxmox.com/debian/pve stretch pvetest
335 |===========================================================
338 {pve} 4.x Repositories
339 ~~~~~~~~~~~~~~~~~~~~~~
341 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
342 out of date. Existing installations should be updated. Nevertheless access to
343 these repositories is still provided.
345 [width="100%",cols="<d,3m",options="header"]
346 |===========================================================
347 |Repository | sources.list entry
348 |{pve} 4.x Enterprise |
349 deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise
350 |{pve} 4.x No-Subscription |
351 deb http://download.proxmox.com/debian/pve jessie pve-no-subscription
353 deb http://download.proxmox.com/debian/pve jessie pvetest
354 |===========================================================
357 {pve} 3.x Repositories
358 ~~~~~~~~~~~~~~~~~~~~~~
360 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
361 out of date. Existing installations should be updated. Nevertheless access to
362 these repositories is still provided.
364 [width="100%",cols="<d,3m",options="header"]
365 |===========================================================
366 |Repository | sources.list entry
367 |{pve} 3.x Enterprise |
368 deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise
369 |{pve} 3.x No-Subscription |
370 deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription
372 deb http://download.proxmox.com/debian/pve wheezy pvetest
373 |===========================================================
376 Outdated: `stable` Repository `pve`
377 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
379 This repository is a leftover to ease the update to 3.1. It will not get any
380 updates after the release of 3.1. Therefore the repository needs to be removed
381 after the upgrade to 3.1.
383 .File `/etc/apt/sources.list`
385 deb http://ftp.debian.org/debian wheezy main contrib
387 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
388 # deb http://download.proxmox.com/debian wheezy pve
391 deb http://security.debian.org/ wheezy/updates main contrib
395 Outdated: {pve} 2.x Repositories
396 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
398 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
399 the latest version as soon as possible. In order to use the stable `pve` 2.x
400 repository, check your sources.list:
402 .File `/etc/apt/sources.list`
404 deb http://ftp.debian.org/debian squeeze main contrib
406 # PVE packages provided by proxmox.com
407 deb http://download.proxmox.com/debian squeeze pve
410 deb http://security.debian.org/ squeeze/updates main contrib
414 Outdated: {pve} VE 1.x Repositories
415 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
417 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
418 to latest version as soon as possible.
423 include::pve-copyright.adoc[]