1 [[sysadmin_package_repositories]]
8 All Debian based systems use
9 http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package
10 management tool. The list of repositories is defined in
11 `/etc/apt/sources.list` and `.list` files found inside
12 `/etc/apt/sources.d/`. Updates can be installed directly using
13 `apt-get`, or via the GUI.
15 Apt `sources.list` files list one package repository per line, with
16 the most preferred source listed first. Empty lines are ignored, and a
17 `#` character anywhere on a line marks the remainder of that line as a
18 comment. The information available from the configured sources is
19 acquired by `apt-get update`.
21 .File `/etc/apt/sources.list`
23 deb http://ftp.debian.org/debian buster main contrib
24 deb http://ftp.debian.org/debian buster-updates main contrib
27 deb http://security.debian.org/debian-security buster/updates main contrib
29 // FIXME for 7.0: change security update suite to bullseye-security
31 In addition, {pve} provides three different package repositories.
33 [[sysadmin_enterprise_repo]]
34 {pve} Enterprise Repository
35 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
37 This is the default, stable and recommended repository, available for
38 all {pve} subscription users. It contains the most stable packages,
39 and is suitable for production use. The `pve-enterprise` repository is
42 .File `/etc/apt/sources.list.d/pve-enterprise.list`
44 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
47 As soon as updates are available, the `root@pam` user is notified via
48 email about the available new packages. On the GUI, the change-log of
49 each package can be viewed (if available), showing all details of the
50 update. So you will never miss important security fixes.
52 Please note that you need a valid subscription key to access this
53 repository. We offer different support levels, and you can find further
54 details at https://www.proxmox.com/en/proxmox-ve/pricing.
56 NOTE: You can disable this repository by commenting out the above line
57 using a `#` (at the start of the line). This prevents error messages
58 if you do not have a subscription key. Please configure the
59 `pve-no-subscription` repository in that case.
62 [[sysadmin_no_subscription_repo]]
63 {pve} No-Subscription Repository
64 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
66 As the name suggests, you do not need a subscription key to access
67 this repository. It can be used for testing and non-production
68 use. Its not recommended to run on production servers, as these
69 packages are not always heavily tested and validated.
71 We recommend to configure this repository in `/etc/apt/sources.list`.
73 .File `/etc/apt/sources.list`
75 deb http://ftp.debian.org/debian buster main contrib
76 deb http://ftp.debian.org/debian buster-updates main contrib
78 # PVE pve-no-subscription repository provided by proxmox.com,
79 # NOT recommended for production use
80 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
83 deb http://security.debian.org/debian-security buster/updates main contrib
87 [[sysadmin_test_repo]]
89 ~~~~~~~~~~~~~~~~~~~~~~
91 Finally, there is a repository called `pvetest`. This one contains the
92 latest packages and is heavily used by developers to test new
93 features. As usual, you can configure this using
94 `/etc/apt/sources.list` by adding the following line:
96 .sources.list entry for `pvetest`
98 deb http://download.proxmox.com/debian/pve buster pvetest
101 WARNING: the `pvetest` repository should (as the name implies) only be used
102 for testing new features or bug fixes.
104 [[sysadmin_package_repositories_ceph]]
105 {pve} Ceph Repository
106 ~~~~~~~~~~~~~~~~~~~~~
108 This is {pve}'s main Ceph repository and holds the Ceph packages for
109 production use. You can also use this repository to update only the Ceph
112 .File `/etc/apt/sources.list.d/ceph.list`
114 deb http://download.proxmox.com/debian/ceph-nautilus buster main
118 {pve} Ceph Testing Repository
119 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
121 This Ceph repository contains the Ceph packages before they are moved into the
122 main repository and is used to test new Ceph release on {pve}.
124 .File `/etc/apt/sources.list.d/ceph.list`
126 deb http://download.proxmox.com/debian/ceph-nautilus buster test
129 {pve} Ceph Luminous Repository For Upgrade
130 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
132 This is a build of tje Ceph Luminous release for {pve} 6.0, this can be used to
133 upgrade a {pve} cluster with Ceph Luminous deployed first to our 6.0 release,
134 based on Debian Buster, and only afterwards upgrade the Ceph on it's own.
136 .File `/etc/apt/sources.list.d/ceph.list`
138 deb http://download.proxmox.com/debian/ceph-luminous buster main
144 We use GnuPG to sign the `Release` files inside those repositories,
145 and APT uses that signatures to verify that all packages are from a
148 The key used for verification is already installed if you install from
149 our installation CD. If you install by other means, you can manually
150 download the key with:
152 # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
154 Please verify the checksum afterwards:
157 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
158 acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
164 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
165 f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
171 // include note about older releases, but only for wiki
174 {pve} 5.x Repositories
175 ~~~~~~~~~~~~~~~~~~~~~~
177 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release
178 is out of date, and you should update your installation.
179 Nevertheless, we still provide access to those repositories at our download
182 [width="100%",cols="<d,3m",options="header"]
183 |===========================================================
184 |Repository | sources.list entry
185 |{pve} 5.x Enterprise |
186 deb https://enterprise.proxmox.com/debian stretch pve-enterprise
187 |{pve} 5.x No-Subscription |
188 deb http://download.proxmox.com/debian stretch pve-no-subscription
190 deb http://download.proxmox.com/debian stretch pvetest
191 |===========================================================
194 {pve} 4.x Repositories
195 ~~~~~~~~~~~~~~~~~~~~~~
197 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this
198 release is out of date, and you should update your
199 installation. Nevertheless, we still provide access to those
200 repositories at our download servers.
202 [width="100%",cols="<d,3m",options="header"]
203 |===========================================================
204 |Repository | sources.list entry
205 |{pve} 4.x Enterprise |
206 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
207 |{pve} 4.x No-Subscription |
208 deb http://download.proxmox.com/debian jessie pve-no-subscription
210 deb http://download.proxmox.com/debian jessie pvetest
211 |===========================================================
214 {pve} 3.x Repositories
215 ~~~~~~~~~~~~~~~~~~~~~~
217 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this
218 release is out of date, and you should update your
219 installation. Nevertheless, we still provide access to those
220 repositories at our download servers.
222 [width="100%",cols="<d,3m",options="header"]
223 |===========================================================
224 |Repository | sources.list entry
225 |{pve} 3.x Enterprise |
226 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
227 |{pve} 3.x No-Subscription |
228 deb http://download.proxmox.com/debian wheezy pve-no-subscription
230 deb http://download.proxmox.com/debian wheezy pvetest
231 |===========================================================
234 Outdated: `stable` Repository `pve`
235 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
237 This repository is a leftover to easy the update to 3.1. It will not
238 get any updates after the release of 3.1. Therefore you need to remove
239 this repository after you upgraded to 3.1.
241 .File `/etc/apt/sources.list`
243 deb http://ftp.debian.org/debian wheezy main contrib
245 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
246 # deb http://download.proxmox.com/debian wheezy pve
249 deb http://security.debian.org/ wheezy/updates main contrib
253 Outdated: {pve} 2.x Repositories
254 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
256 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please
257 upgrade to latest version as soon as possible. In order to use the
258 stable `pve` 2.x repository, check your sources.list:
260 .File `/etc/apt/sources.list`
262 deb http://ftp.debian.org/debian squeeze main contrib
264 # PVE packages provided by proxmox.com
265 deb http://download.proxmox.com/debian squeeze pve
268 deb http://security.debian.org/ squeeze/updates main contrib
272 Outdated: {pve} VE 1.x Repositories
273 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
275 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please
276 upgrade to latest version as soon as possible.
281 include::pve-copyright.adoc[]