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.
14 Repositories are a collection of software packages, they can be used to install
15 new software, but are also important to get new updates.
17 NOTE: You need valid Debian and Proxmox repositories to get the latest
18 security updates, bug fixes and new features.
20 APT Repositories are defined in the file `/etc/apt/sources.list` and in `.list`
21 files placed in `/etc/apt/sources.list.d/`.
26 [thumbnail="screenshot/gui-node-repositories.png"]
28 Since Proxmox VE 7, you can check the repository state in the web interface.
29 The node summary panel shows a high level status overview, while the separate
30 'Repository' panel shows in-depth status and list of all configured
33 Basic repository management, for example, activating or deactivating a
34 repository, is also supported.
39 In a `sources.list` file, each line defines a package repository. The preferred
40 source must come first. Empty lines are ignored. A `#` character anywhere on a
41 line marks the remainder of that line as a comment. The available packages from
42 a repository are acquired by running `apt-get update`. Updates can be installed
43 directly using `apt-get`, or via the GUI (Node -> Updates).
45 .File `/etc/apt/sources.list`
47 deb http://deb.debian.org/debian bookworm main contrib
48 deb http://deb.debian.org/debian bookworm-updates main contrib
51 deb http://security.debian.org/debian-security bookworm-security main contrib
54 {pve} provides three different package repositories.
56 [[sysadmin_enterprise_repo]]
57 {pve} Enterprise Repository
58 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
60 This is the default, stable, and recommended repository, available for all {pve}
61 subscription users. It contains the most stable packages and is suitable for
62 production use. The `pve-enterprise` repository is enabled by default:
64 .File `/etc/apt/sources.list.d/pve-enterprise.list`
66 deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise
69 The `root@pam` user is notified via email about available updates. Click the
70 'Changelog' button in the GUI to see more details about the selected update.
72 You need a valid subscription key to access the `pve-enterprise` repository.
73 Different support levels are available. Further details can be found at
74 https://www.proxmox.com/en/proxmox-virtual-environment/pricing.
76 NOTE: You can disable this repository by commenting out the above line using a
77 `#` (at the start of the line). This prevents error messages if your host does
78 not have a subscription key. Please configure the `pve-no-subscription`
79 repository in that case.
81 [[sysadmin_no_subscription_repo]]
82 {pve} No-Subscription Repository
83 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
85 This is the recommended repository for testing and non-production use. Its
86 packages are not as heavily tested and validated. You don't need a subscription key
87 to access the `pve-no-subscription` repository.
89 We recommend to configure this repository in `/etc/apt/sources.list`.
91 .File `/etc/apt/sources.list`
93 deb http://ftp.debian.org/debian bookworm main contrib
94 deb http://ftp.debian.org/debian bookworm-updates main contrib
96 # Proxmox VE pve-no-subscription repository provided by proxmox.com,
97 # NOT recommended for production use
98 deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
101 deb http://security.debian.org/debian-security bookworm-security main contrib
105 [[sysadmin_test_repo]]
106 {pve} Test Repository
107 ~~~~~~~~~~~~~~~~~~~~~~
109 This repository contains the latest packages and is primarily used by developers
110 to test new features. To configure it, add the following line to
111 `/etc/apt/sources.list`:
113 .sources.list entry for `pvetest`
115 deb http://download.proxmox.com/debian/pve bookworm pvetest
118 WARNING: The `pvetest` repository should (as the name implies) only be used for
119 testing new features or bug fixes.
121 [[sysadmin_package_repositories_ceph]]
122 Ceph Reef Enterprise Repository
123 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
125 This repository holds the enterprise {pve} Ceph 18.2 Reef packages. They are
126 suitable for production. Use this repository if you run the Ceph client or a
127 full Ceph cluster on {pve}.
129 .File `/etc/apt/sources.list.d/ceph.list`
131 deb https://enterprise.proxmox.com/debian/ceph-reef bookworm enterprise
135 Ceph Reef No-Subscription Repository
136 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
138 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
139 to the enterprise repository and after they where on the test repository.
141 NOTE: It's recommended to use the enterprise repository for production
144 .File `/etc/apt/sources.list.d/ceph.list`
146 deb http://download.proxmox.com/debian/ceph-reef bookworm no-subscription
150 Ceph Reef Test Repository
151 ~~~~~~~~~~~~~~~~~~~~~~~~~
153 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
154 to the main repository. It is used to test new Ceph releases on {pve}.
156 .File `/etc/apt/sources.list.d/ceph.list`
158 deb http://download.proxmox.com/debian/ceph-reef bookworm test
161 Ceph Quincy Enterprise Repository
162 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
164 This repository holds the enterprise {pve} Ceph Quincy packages. They are
165 suitable for production. Use this repository if you run the Ceph client or a
166 full Ceph cluster on {pve}.
168 .File `/etc/apt/sources.list.d/ceph.list`
170 deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise
174 Ceph Quincy No-Subscription Repository
175 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
177 This Ceph repository contains the Ceph Quincy packages before they are moved
178 to the enterprise repository and after they where on the test repository.
180 NOTE: It's recommended to use the enterprise repository for production
183 .File `/etc/apt/sources.list.d/ceph.list`
185 deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription
189 Ceph Quincy Test Repository
190 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
192 This Ceph repository contains the Ceph Quincy packages before they are moved
193 to the main repository. It is used to test new Ceph releases on {pve}.
195 .File `/etc/apt/sources.list.d/ceph.list`
197 deb http://download.proxmox.com/debian/ceph-quincy bookworm test
200 Older Ceph Repositories
201 ~~~~~~~~~~~~~~~~~~~~~~~
203 {pve} 8 doesn't support Ceph Pacific, Ceph Octopus, or even older releases for
204 hyper-converged setups. For those releases, you need to first upgrade Ceph to a
205 newer release before upgrading to Proxmox VE 8.
208 https://pve.proxmox.com/wiki/Category:Ceph_Upgrade[upgrade guide] for details.
211 [[sysadmin_debian_firmware_repo]]
212 Debian Firmware Repository
213 ~~~~~~~~~~~~~~~~~~~~~~~~~~
215 Starting with Debian Bookworm ({pve} 8) non-free firmware (as defined by
216 https://www.debian.org/social_contract#guidelines[DFSG]) has been moved to the
217 newly created Debian repository component `non-free-firmware`.
219 Enable this repository if you want to set up
220 xref:sysadmin_firmware_cpu[Early OS Microcode Updates] or need additional
221 xref:sysadmin_firmware_runtime_files[Runtime Firmware Files] not already
222 included in the pre-installed package `pve-firmware`.
224 To be able to install packages from this component, run
225 `editor /etc/apt/sources.list`, append `non-free-firmware` to the end of each
226 `.debian.org` repository line and run `apt update`.
234 The 'Release' files in the repositories are signed with GnuPG. APT is using
235 these signatures to verify that all packages are from a trusted source.
237 If you install {pve} from an official ISO image, the key for verification is
240 If you install {pve} on top of Debian, download and install
241 the key with the following commands:
244 # wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
247 Verify the checksum afterwards with the `sha512sum` CLI tool:
250 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
251 7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87 /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
254 or the `md5sum` CLI tool:
257 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
258 41558dc019ef90bd0f6067644a51cf5b /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
264 // include note about older releases, but only for wiki
266 {pve} 7.x Repositories
267 ~~~~~~~~~~~~~~~~~~~~~~
269 {pve} 7.x is based on Debian 11.x (``bullseye''). Please note that this release
270 is out of date (see the xref:faq-support-table[FAQ support table]). Existing
271 installations should be updated. Nevertheless access to these repositories is
274 [width="100%",cols="<d,3m",options="header"]
275 |===========================================================
276 |Repository | sources.list entry
277 |{pve} 7.x Enterprise |
278 deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise
279 |{pve} 7.x No-Subscription |
280 deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
282 deb http://download.proxmox.com/debian/pve bullseye pvetest
283 |===========================================================
285 Release key URL: https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg
287 Release key hash sums:
290 sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
291 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa
293 md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
294 bcc35c7173e0845c0d6ad6470b70f50e
298 {pve} 6.x Repositories
299 ~~~~~~~~~~~~~~~~~~~~~~
301 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
302 out of date. Existing installations should be updated. Nevertheless access to
303 these repositories is still provided.
305 [width="100%",cols="<d,3m",options="header"]
306 |===========================================================
307 |Repository | sources.list entry
308 |{pve} 6.x Enterprise |
309 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
310 |{pve} 6.x No-Subscription |
311 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
313 deb http://download.proxmox.com/debian/pve buster pvetest
314 |===========================================================
317 {pve} 5.x Repositories
318 ~~~~~~~~~~~~~~~~~~~~~~
320 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
321 out of date. Existing installations should be updated. Nevertheless access to
322 these repositories is still provided.
324 [width="100%",cols="<d,3m",options="header"]
325 |===========================================================
326 |Repository | sources.list entry
327 |{pve} 5.x Enterprise |
328 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
329 |{pve} 5.x No-Subscription |
330 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
332 deb http://download.proxmox.com/debian/pve stretch pvetest
333 |===========================================================
336 {pve} 4.x Repositories
337 ~~~~~~~~~~~~~~~~~~~~~~
339 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
340 out of date. Existing installations should be updated. Nevertheless access to
341 these repositories is still provided.
343 [width="100%",cols="<d,3m",options="header"]
344 |===========================================================
345 |Repository | sources.list entry
346 |{pve} 4.x Enterprise |
347 deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise
348 |{pve} 4.x No-Subscription |
349 deb http://download.proxmox.com/debian/pve jessie pve-no-subscription
351 deb http://download.proxmox.com/debian/pve jessie pvetest
352 |===========================================================
355 {pve} 3.x Repositories
356 ~~~~~~~~~~~~~~~~~~~~~~
358 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
359 out of date. Existing installations should be updated. Nevertheless access to
360 these repositories is still provided.
362 [width="100%",cols="<d,3m",options="header"]
363 |===========================================================
364 |Repository | sources.list entry
365 |{pve} 3.x Enterprise |
366 deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise
367 |{pve} 3.x No-Subscription |
368 deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription
370 deb http://download.proxmox.com/debian/pve wheezy pvetest
371 |===========================================================
374 Outdated: `stable` Repository `pve`
375 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
377 This repository is a leftover to ease the update to 3.1. It will not get any
378 updates after the release of 3.1. Therefore the repository needs to be removed
379 after the upgrade to 3.1.
381 .File `/etc/apt/sources.list`
383 deb http://ftp.debian.org/debian wheezy main contrib
385 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
386 # deb http://download.proxmox.com/debian wheezy pve
389 deb http://security.debian.org/ wheezy/updates main contrib
393 Outdated: {pve} 2.x Repositories
394 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
396 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
397 the latest version as soon as possible. In order to use the stable `pve` 2.x
398 repository, check your sources.list:
400 .File `/etc/apt/sources.list`
402 deb http://ftp.debian.org/debian squeeze main contrib
404 # PVE packages provided by proxmox.com
405 deb http://download.proxmox.com/debian squeeze pve
408 deb http://security.debian.org/ squeeze/updates main contrib
412 Outdated: {pve} VE 1.x Repositories
413 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
415 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
416 to latest version as soon as possible.
421 include::pve-copyright.adoc[]