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. Repositories are
10 defined in the file `/etc/apt/sources.list` and in `.list` files placed in
11 `/etc/apt/sources.list.d/`.
13 Each line defines a package repository. The preferred source must come first.
14 Empty lines are ignored. A `#` character anywhere on a line marks the remainder
15 of that line as a comment. The available packages from a repository are acquired
16 by running `apt-get update`. Updates can be installed directly using `apt-get`,
19 .File `/etc/apt/sources.list`
21 deb http://ftp.debian.org/debian bullseye main contrib
22 deb http://ftp.debian.org/debian bullseye-updates main contrib
25 deb http://security.debian.org/debian-security bullseye-security main contrib
28 {pve} additionally provides three different package repositories.
30 [[sysadmin_enterprise_repo]]
31 {pve} Enterprise Repository
32 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
34 This is the default, stable, and recommended repository, available for all {pve}
35 subscription users. It contains the most stable packages and is suitable for
36 production use. The `pve-enterprise` repository is enabled by default:
38 .File `/etc/apt/sources.list.d/pve-enterprise.list`
40 deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise
43 The `root@pam` user is notified via email about available updates. Click the
44 'Changelog' button in the GUI to see more details about the selected update.
46 You need a valid subscription key to access the `pve-enterprise` repository.
47 Different support levels are available. Further details can be found at
48 https://www.proxmox.com/en/proxmox-ve/pricing.
50 NOTE: You can disable this repository by commenting out the above line using a
51 `#` (at the start of the line). This prevents error messages if you do not have
52 a subscription key. Please configure the `pve-no-subscription` repository in
55 [[sysadmin_no_subscription_repo]]
56 {pve} No-Subscription Repository
57 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
59 This is the recommended repository for testing and non-production use. Its
60 packages are not as heavily tested and validated. You don't need a subscription key
61 to access the `pve-no-subscription` repository.
63 We recommend to configure this repository in `/etc/apt/sources.list`.
65 .File `/etc/apt/sources.list`
67 deb http://ftp.debian.org/debian bullseye main contrib
68 deb http://ftp.debian.org/debian bullseye-updates main contrib
70 # PVE pve-no-subscription repository provided by proxmox.com,
71 # NOT recommended for production use
72 deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
75 deb http://security.debian.org/debian-security bullseye-security main contrib
79 [[sysadmin_test_repo]]
81 ~~~~~~~~~~~~~~~~~~~~~~
83 This repository contains the latest packages and is primarily used by developers
84 to test new features. To configure it, add the following line to
85 `etc/apt/sources.list`:
87 .sources.list entry for `pvetest`
89 deb http://download.proxmox.com/debian/pve bullseye pvetest
92 WARNING: The `pvetest` repository should (as the name implies) only be used for
93 testing new features or bug fixes.
95 [[sysadmin_package_repositories_ceph]]
96 Ceph Pacific Repository
97 ~~~~~~~~~~~~~~~~~~~~~~~
99 NOTE: Ceph Pacific (16.2) was declared stable with {pve} 7.0.
101 This repository holds the main {pve} Ceph Pacific packages. They are suitable
102 for production. Use this repository if you run the Ceph client or a full Ceph
105 .File `/etc/apt/sources.list.d/ceph.list`
107 deb http://download.proxmox.com/debian/ceph-pacific bullseye main
111 Ceph Pacific Test Repository
112 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
114 This Ceph repository contains the Ceph Pacific packages before they are moved
115 to the main repository. It is used to test new Ceph releases on {pve}.
117 .File `/etc/apt/sources.list.d/ceph.list`
119 deb http://download.proxmox.com/debian/ceph-pacific bullseye test
122 [[sysadmin_package_repositories_ceph_octopus]]
123 Ceph Octopus Repository
124 ~~~~~~~~~~~~~~~~~~~~~~~
126 NOTE: Ceph Octopus (15.2) was declared stable with {pve} 6.3 it will continue
127 to get updates for the xref:faq-support-table[remaining life time of the 6.x release]
128 and also for {pve} 7.x until Ceph Octopus upstream EOL (~ 2022-07).
130 This repository holds the main {pve} Ceph Octopus packages. They are suitable
131 for production. Use this repository if you run the Ceph client or a full Ceph
134 .File `/etc/apt/sources.list.d/ceph.list`
136 deb http://download.proxmox.com/debian/ceph-octopus bullseye main
139 Note that on an older {pve} 6.x you need to change `bullseye` to `buster` in
140 the repository specification above.
143 Ceph Octopus Test Repository
144 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
146 This Ceph repository contains the Ceph packages before they are moved to the
147 main repository. It is used to test new Ceph releases on {pve}.
149 .File `/etc/apt/sources.list.d/ceph.list`
151 deb http://download.proxmox.com/debian/ceph-octopus bullseye test
157 The 'Release' files in the repositories are signed with GnuPG. APT is using
158 these signatures to verify that all packages are from a trusted source.
160 If you install {pve} from an official ISO image, the key for verification is
163 If you install {pve} on top of Debian, download and install
164 the key with the following commands:
167 # wget https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
170 Verify the checksum afterwards with:
173 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
176 The output should be:
179 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
185 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
187 The output should be:
190 bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
196 // include note about older releases, but only for wiki
199 {pve} 6.x Repositories
200 ~~~~~~~~~~~~~~~~~~~~~~
202 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
203 out of date. Existing installations should be updated. Nevertheless access to
204 these repositories is still provided.
206 [width="100%",cols="<d,3m",options="header"]
207 |===========================================================
208 |Repository | sources.list entry
209 |{pve} 6.x Enterprise |
210 deb https://enterprise.proxmox.com/debian buster pve-enterprise
211 |{pve} 6.x No-Subscription |
212 deb http://download.proxmox.com/debian buster pve-no-subscription
214 deb http://download.proxmox.com/debian buster pvetest
215 |===========================================================
218 {pve} 5.x Repositories
219 ~~~~~~~~~~~~~~~~~~~~~~
221 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
222 out of date. Existing installations should be updated. Nevertheless access to
223 these repositories is still provided.
225 [width="100%",cols="<d,3m",options="header"]
226 |===========================================================
227 |Repository | sources.list entry
228 |{pve} 5.x Enterprise |
229 deb https://enterprise.proxmox.com/debian stretch pve-enterprise
230 |{pve} 5.x No-Subscription |
231 deb http://download.proxmox.com/debian stretch pve-no-subscription
233 deb http://download.proxmox.com/debian stretch pvetest
234 |===========================================================
237 {pve} 4.x Repositories
238 ~~~~~~~~~~~~~~~~~~~~~~
240 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
241 out of date. Existing installations should be updated. Nevertheless access to
242 these repositories is still provided.
244 [width="100%",cols="<d,3m",options="header"]
245 |===========================================================
246 |Repository | sources.list entry
247 |{pve} 4.x Enterprise |
248 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
249 |{pve} 4.x No-Subscription |
250 deb http://download.proxmox.com/debian jessie pve-no-subscription
252 deb http://download.proxmox.com/debian jessie pvetest
253 |===========================================================
256 {pve} 3.x Repositories
257 ~~~~~~~~~~~~~~~~~~~~~~
259 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
260 out of date. Existing installations should be updated. Nevertheless access to
261 these repositories is still provided.
263 [width="100%",cols="<d,3m",options="header"]
264 |===========================================================
265 |Repository | sources.list entry
266 |{pve} 3.x Enterprise |
267 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
268 |{pve} 3.x No-Subscription |
269 deb http://download.proxmox.com/debian wheezy pve-no-subscription
271 deb http://download.proxmox.com/debian wheezy pvetest
272 |===========================================================
275 Outdated: `stable` Repository `pve`
276 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
278 This repository is a leftover to ease the update to 3.1. It will not get any
279 updates after the release of 3.1. Therefore the repository needs to be removed
280 after the upgrade to 3.1.
282 .File `/etc/apt/sources.list`
284 deb http://ftp.debian.org/debian wheezy main contrib
286 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
287 # deb http://download.proxmox.com/debian wheezy pve
290 deb http://security.debian.org/ wheezy/updates main contrib
294 Outdated: {pve} 2.x Repositories
295 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
297 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
298 the latest version as soon as possible. In order to use the stable `pve` 2.x
299 repository, check your sources.list:
301 .File `/etc/apt/sources.list`
303 deb http://ftp.debian.org/debian squeeze main contrib
305 # PVE packages provided by proxmox.com
306 deb http://download.proxmox.com/debian squeeze pve
309 deb http://security.debian.org/ squeeze/updates main contrib
313 Outdated: {pve} VE 1.x Repositories
314 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
316 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
317 to latest version as soon as possible.
322 include::pve-copyright.adoc[]