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 buster main contrib
22 deb http://ftp.debian.org/debian buster-updates main contrib
25 deb http://security.debian.org/debian-security buster/updates main contrib
27 // FIXME for 7.0: change security update suite to bullseye-security
29 {pve} additionally provides three different package repositories.
31 [[sysadmin_enterprise_repo]]
32 {pve} Enterprise Repository
33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
35 This is the default, stable, and recommended repository, available for all {pve}
36 subscription users. It contains the most stable packages and is suitable for
37 production use. The `pve-enterprise` repository is enabled by default:
39 .File `/etc/apt/sources.list.d/pve-enterprise.list`
41 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
44 The `root@pam` user is notified via email about available updates. Click the
45 'Changelog' button in the GUI to see more details about the selected update.
47 You need a valid subscription key to access the `pve-enterprise` repository.
48 Different support levels are available. Further details can be found at
49 https://www.proxmox.com/en/proxmox-ve/pricing.
51 NOTE: You can disable this repository by commenting out the above line using a
52 `#` (at the start of the line). This prevents error messages if you do not have
53 a subscription key. Please configure the `pve-no-subscription` repository in
56 [[sysadmin_no_subscription_repo]]
57 {pve} No-Subscription Repository
58 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
60 This is the recommended repository for testing and non-production use. Its
61 packages are not as heavily tested and validated. You don't need a subscription key
62 to access the `pve-no-subscription` repository.
64 We recommend to configure this repository in `/etc/apt/sources.list`.
66 .File `/etc/apt/sources.list`
68 deb http://ftp.debian.org/debian buster main contrib
69 deb http://ftp.debian.org/debian buster-updates main contrib
71 # PVE pve-no-subscription repository provided by proxmox.com,
72 # NOT recommended for production use
73 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
76 deb http://security.debian.org/debian-security buster/updates main contrib
80 [[sysadmin_test_repo]]
82 ~~~~~~~~~~~~~~~~~~~~~~
84 This repository contains the latest packages and is primarily used by developers
85 to test new features. To configure it, add the following line to
86 `etc/apt/sources.list`:
88 .sources.list entry for `pvetest`
90 deb http://download.proxmox.com/debian/pve buster pvetest
93 WARNING: The `pvetest` repository should (as the name implies) only be used for
94 testing new features or bug fixes.
96 [[sysadmin_package_repositories_ceph]]
97 Ceph Octopus Repository
98 ~~~~~~~~~~~~~~~~~~~~~~~
100 NOTE: Ceph Octopus (15.2) was declared stable with {pve} 6.3 and is the most
101 recent Ceph release supported. It will continue to get updates for the
102 xref:faq-support-table[remaining life time of the 6.x release].
104 This repository holds the main {pve} Ceph Octopus packages. They are suitable
105 for production. Use this repository if you run the Ceph client or a full Ceph
108 .File `/etc/apt/sources.list.d/ceph.list`
110 deb http://download.proxmox.com/debian/ceph-octopus buster main
114 Ceph Octopus Test Repository
115 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
117 This Ceph repository contains the Ceph packages before they are moved to the
118 main repository. It is used to test new Ceph releases on {pve}.
120 .File `/etc/apt/sources.list.d/ceph.list`
122 deb http://download.proxmox.com/debian/ceph-octopus buster test
125 Ceph Nautilus Repository
126 ~~~~~~~~~~~~~~~~~~~~~~~~
128 NOTE: Ceph Nautlius (14.2) is the older supported Ceph version, introduced with
129 {pve} 6.0. It will continue to get updates until end of Q2 2021, so you will
131 https://pve.proxmox.com/wiki/Ceph_Nautilus_to_Octopus[upgrade to Ceph Octopus].
133 This repository holds the main {pve} Ceph Nautilus packages. They are suitable
134 for production. Use this repository if you run the Ceph client or a full Ceph
137 .File `/etc/apt/sources.list.d/ceph.list`
139 deb http://download.proxmox.com/debian/ceph-nautilus buster main
143 Ceph Nautilus 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-nautilus buster test
154 {pve} Ceph Luminous Repository For Upgrade
155 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
157 If Ceph is deployed this repository is needed for the upgrade from {pve} 5.x to
158 {pve} 6.0. It provides packages for the older Ceph Luminous release for {pve}
161 The https://pve.proxmox.com/wiki/Upgrade_from_5.x_to_6.0[Upgrade 5.x to 6.0]
162 document explains how to use this repository in detail.
164 .File `/etc/apt/sources.list.d/ceph.list`
166 deb http://download.proxmox.com/debian/ceph-luminous buster main
172 The 'Release' files in the repositories are signed with GnuPG. APT is using
173 these signatures to verify that all packages are from a trusted source.
175 If you install {pve} from an official ISO image, the key for verification is
178 If you install {pve} on top of Debian, download and install
179 the key with the following commands:
182 # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
185 Verify the checksum afterwards with:
188 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
191 The output should be:
194 acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
200 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
202 The output should be:
205 f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
211 // include note about older releases, but only for wiki
214 {pve} 5.x Repositories
215 ~~~~~~~~~~~~~~~~~~~~~~
217 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
218 out of date. Existing installations should be updated. Nevertheless access to
219 these repositories is still provided.
221 [width="100%",cols="<d,3m",options="header"]
222 |===========================================================
223 |Repository | sources.list entry
224 |{pve} 5.x Enterprise |
225 deb https://enterprise.proxmox.com/debian stretch pve-enterprise
226 |{pve} 5.x No-Subscription |
227 deb http://download.proxmox.com/debian stretch pve-no-subscription
229 deb http://download.proxmox.com/debian stretch pvetest
230 |===========================================================
233 {pve} 4.x Repositories
234 ~~~~~~~~~~~~~~~~~~~~~~
236 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
237 out of date. Existing installations should be updated. Nevertheless access to
238 these repositories is still provided.
240 [width="100%",cols="<d,3m",options="header"]
241 |===========================================================
242 |Repository | sources.list entry
243 |{pve} 4.x Enterprise |
244 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
245 |{pve} 4.x No-Subscription |
246 deb http://download.proxmox.com/debian jessie pve-no-subscription
248 deb http://download.proxmox.com/debian jessie pvetest
249 |===========================================================
252 {pve} 3.x Repositories
253 ~~~~~~~~~~~~~~~~~~~~~~
255 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
256 out of date. Existing installations should be updated. Nevertheless access to
257 these repositories is still provided.
259 [width="100%",cols="<d,3m",options="header"]
260 |===========================================================
261 |Repository | sources.list entry
262 |{pve} 3.x Enterprise |
263 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
264 |{pve} 3.x No-Subscription |
265 deb http://download.proxmox.com/debian wheezy pve-no-subscription
267 deb http://download.proxmox.com/debian wheezy pvetest
268 |===========================================================
271 Outdated: `stable` Repository `pve`
272 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
274 This repository is a leftover to ease the update to 3.1. It will not get any
275 updates after the release of 3.1. Therefore the repository needs to be removed
276 after the upgrade to 3.1.
278 .File `/etc/apt/sources.list`
280 deb http://ftp.debian.org/debian wheezy main contrib
282 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
283 # deb http://download.proxmox.com/debian wheezy pve
286 deb http://security.debian.org/ wheezy/updates main contrib
290 Outdated: {pve} 2.x Repositories
291 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
293 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
294 the latest version as soon as possible. In order to use the stable `pve` 2.x
295 repository, check your sources.list:
297 .File `/etc/apt/sources.list`
299 deb http://ftp.debian.org/debian squeeze main contrib
301 # PVE packages provided by proxmox.com
302 deb http://download.proxmox.com/debian squeeze pve
305 deb http://security.debian.org/ squeeze/updates main contrib
309 Outdated: {pve} VE 1.x Repositories
310 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
312 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
313 to latest version as soon as possible.
318 include::pve-copyright.adoc[]