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.0 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://ftp.debian.org/debian bullseye main contrib
48 deb http://ftp.debian.org/debian bullseye-updates main contrib
51 deb http://security.debian.org/debian-security bullseye-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 bullseye 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-ve/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 you do not have
78 a subscription key. Please configure the `pve-no-subscription` repository in
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 bullseye main contrib
94 deb http://ftp.debian.org/debian bullseye-updates main contrib
96 # PVE pve-no-subscription repository provided by proxmox.com,
97 # NOT recommended for production use
98 deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
101 deb http://security.debian.org/debian-security bullseye-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 bullseye 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 Quincy Repository
123 ~~~~~~~~~~~~~~~~~~~~~~
125 NOTE: Ceph Quincy (17.2) was declared stable with {pve} 7.3 or after using the
128 This repository holds the main {pve} Ceph Quincy packages. They are suitable
129 for production. Use this repository if you run the Ceph client or a full Ceph
132 .File `/etc/apt/sources.list.d/ceph.list`
134 deb http://download.proxmox.com/debian/ceph-quincy bullseye main
138 Ceph Quincy Test Repository
139 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
141 This Ceph repository contains the Ceph Quincy packages before they are moved
142 to the main repository. It is used to test new Ceph releases on {pve}.
144 .File `/etc/apt/sources.list.d/ceph.list`
146 deb http://download.proxmox.com/debian/ceph-quincy bullseye test
149 Ceph Pacific Repository
150 ~~~~~~~~~~~~~~~~~~~~~~~
152 NOTE: Ceph Pacific (16.2) was declared stable with {pve} 7.0.
154 This repository holds the main {pve} Ceph Pacific packages. They are suitable
155 for production. Use this repository if you run the Ceph client or a full Ceph
158 .File `/etc/apt/sources.list.d/ceph.list`
160 deb http://download.proxmox.com/debian/ceph-pacific bullseye main
164 Ceph Pacific Test Repository
165 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
167 This Ceph repository contains the Ceph Pacific packages before they are moved
168 to the main repository. It is used to test new Ceph releases on {pve}.
170 .File `/etc/apt/sources.list.d/ceph.list`
172 deb http://download.proxmox.com/debian/ceph-pacific bullseye test
175 [[sysadmin_package_repositories_ceph_octopus]]
176 Ceph Octopus Repository
177 ~~~~~~~~~~~~~~~~~~~~~~~
179 NOTE: Ceph Octopus (15.2) was declared stable with {pve} 6.3. It will continue
180 to get updates for the xref:faq-support-table[remaining life time of the 6.x release]
181 and also for {pve} 7.x until Ceph Octopus upstream EOL (~ 2022-07).
183 This repository holds the main {pve} Ceph Octopus packages. They are suitable
184 for production. Use this repository if you run the Ceph client or a full Ceph
187 .File `/etc/apt/sources.list.d/ceph.list`
189 deb http://download.proxmox.com/debian/ceph-octopus bullseye main
192 Note that on an older {pve} 6.x you need to change `bullseye` to `buster` in
193 the repository specification above.
196 Ceph Octopus Test Repository
197 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
199 This Ceph repository contains the Ceph packages before they are moved to the
200 main repository. It is used to test new Ceph releases on {pve}.
202 .File `/etc/apt/sources.list.d/ceph.list`
204 deb http://download.proxmox.com/debian/ceph-octopus bullseye test
212 The 'Release' files in the repositories are signed with GnuPG. APT is using
213 these signatures to verify that all packages are from a trusted source.
215 If you install {pve} from an official ISO image, the key for verification is
218 If you install {pve} on top of Debian, download and install
219 the key with the following commands:
222 # wget https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
225 Verify the checksum afterwards with the `sha512sum` CLI tool:
228 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
229 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
232 or the `md5sum` CLI tool:
235 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
236 bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
242 // include note about older releases, but only for wiki
245 {pve} 6.x Repositories
246 ~~~~~~~~~~~~~~~~~~~~~~
248 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
249 out of date. Existing installations should be updated. Nevertheless access to
250 these repositories is still provided.
252 [width="100%",cols="<d,3m",options="header"]
253 |===========================================================
254 |Repository | sources.list entry
255 |{pve} 6.x Enterprise |
256 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
257 |{pve} 6.x No-Subscription |
258 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
260 deb http://download.proxmox.com/debian/pve buster pvetest
261 |===========================================================
264 {pve} 5.x Repositories
265 ~~~~~~~~~~~~~~~~~~~~~~
267 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
268 out of date. Existing installations should be updated. Nevertheless access to
269 these repositories is still provided.
271 [width="100%",cols="<d,3m",options="header"]
272 |===========================================================
273 |Repository | sources.list entry
274 |{pve} 5.x Enterprise |
275 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
276 |{pve} 5.x No-Subscription |
277 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
279 deb http://download.proxmox.com/debian/pve stretch pvetest
280 |===========================================================
283 {pve} 4.x Repositories
284 ~~~~~~~~~~~~~~~~~~~~~~
286 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
287 out of date. Existing installations should be updated. Nevertheless access to
288 these repositories is still provided.
290 [width="100%",cols="<d,3m",options="header"]
291 |===========================================================
292 |Repository | sources.list entry
293 |{pve} 4.x Enterprise |
294 deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise
295 |{pve} 4.x No-Subscription |
296 deb http://download.proxmox.com/debian/pve jessie pve-no-subscription
298 deb http://download.proxmox.com/debian/pve jessie pvetest
299 |===========================================================
302 {pve} 3.x Repositories
303 ~~~~~~~~~~~~~~~~~~~~~~
305 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
306 out of date. Existing installations should be updated. Nevertheless access to
307 these repositories is still provided.
309 [width="100%",cols="<d,3m",options="header"]
310 |===========================================================
311 |Repository | sources.list entry
312 |{pve} 3.x Enterprise |
313 deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise
314 |{pve} 3.x No-Subscription |
315 deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription
317 deb http://download.proxmox.com/debian/pve wheezy pvetest
318 |===========================================================
321 Outdated: `stable` Repository `pve`
322 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
324 This repository is a leftover to ease the update to 3.1. It will not get any
325 updates after the release of 3.1. Therefore the repository needs to be removed
326 after the upgrade to 3.1.
328 .File `/etc/apt/sources.list`
330 deb http://ftp.debian.org/debian wheezy main contrib
332 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
333 # deb http://download.proxmox.com/debian wheezy pve
336 deb http://security.debian.org/ wheezy/updates main contrib
340 Outdated: {pve} 2.x Repositories
341 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
343 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
344 the latest version as soon as possible. In order to use the stable `pve` 2.x
345 repository, check your sources.list:
347 .File `/etc/apt/sources.list`
349 deb http://ftp.debian.org/debian squeeze main contrib
351 # PVE packages provided by proxmox.com
352 deb http://download.proxmox.com/debian squeeze pve
355 deb http://security.debian.org/ squeeze/updates main contrib
359 Outdated: {pve} VE 1.x Repositories
360 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
362 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
363 to latest version as soon as possible.
368 include::pve-copyright.adoc[]