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 buster/updates main contrib
30 In addition, {pve} provides three different package repositories.
32 [[sysadmin_enterprise_repo]]
33 {pve} Enterprise Repository
34 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
36 This is the default, stable and recommended repository, available for
37 all {pve} subscription users. It contains the most stable packages,
38 and is suitable for production use. The `pve-enterprise` repository is
41 .File `/etc/apt/sources.list.d/pve-enterprise.list`
43 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
46 As soon as updates are available, the `root@pam` user is notified via
47 email about the available new packages. On the GUI, the change-log of
48 each package can be viewed (if available), showing all details of the
49 update. So you will never miss important security fixes.
51 Please note that you need a valid subscription key to access this
52 repository. We offer different support levels, and you can find further
53 details at https://www.proxmox.com/en/proxmox-ve/pricing.
55 NOTE: You can disable this repository by commenting out the above line
56 using a `#` (at the start of the line). This prevents error messages
57 if you do not have a subscription key. Please configure the
58 `pve-no-subscription` repository in that case.
61 [[sysadmin_no_subscription_repo]]
62 {pve} No-Subscription Repository
63 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
65 As the name suggests, you do not need a subscription key to access
66 this repository. It can be used for testing and non-production
67 use. Its not recommended to run on production servers, as these
68 packages are not always heavily tested and validated.
70 We recommend to configure this repository in `/etc/apt/sources.list`.
72 .File `/etc/apt/sources.list`
74 deb http://ftp.debian.org/debian buster main contrib
75 deb http://ftp.debian.org/debian buster-updates main contrib
77 # PVE pve-no-subscription repository provided by proxmox.com,
78 # NOT recommended for production use
79 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
82 deb http://security.debian.org buster/updates main contrib
86 [[sysadmin_test_repo]]
88 ~~~~~~~~~~~~~~~~~~~~~~
90 Finally, there is a repository called `pvetest`. This one contains the
91 latest packages and is heavily used by developers to test new
92 features. As usual, you can configure this using
93 `/etc/apt/sources.list` by adding the following line:
95 .sources.list entry for `pvetest`
97 deb http://download.proxmox.com/debian/pve buster pvetest
100 WARNING: the `pvetest` repository should (as the name implies) only be used
101 for testing new features or bug fixes.
103 [[sysadmin_package_repositories_ceph]]
104 {pve} Ceph Repository
105 ~~~~~~~~~~~~~~~~~~~~~
107 This is {pve}'s main Ceph repository and holds the Ceph packages for
108 production use. You can also use this repository to update only the Ceph
111 .File `/etc/apt/sources.list.d/ceph.list`
113 deb http://download.proxmox.com/debian/ceph-nautilus buster main
117 {pve} Ceph Testing Repository
118 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
120 This Ceph repository contains the Ceph packages before they are moved into the
121 main repository and is used to test new Ceph release on {pve}.
123 .File `/etc/apt/sources.list.d/ceph.list`
125 deb http://download.proxmox.com/debian/ceph-nautilus buster test
128 {pve} Ceph Luminous Repository For Upgrade
129 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
131 This is a build of tje Ceph Luminous release for {pve} 6.0, this can be used to
132 upgrade a {pve} cluster with Ceph Luminous deployed first to our 6.0 release,
133 based on Debian Buster, and only afterwards upgrade the Ceph on it's own.
135 .File `/etc/apt/sources.list.d/ceph.list`
137 deb http://download.proxmox.com/debian/ceph-luminous buster main
143 We use GnuPG to sign the `Release` files inside those repositories,
144 and APT uses that signatures to verify that all packages are from a
147 The key used for verification is already installed if you install from
148 our installation CD. If you install by other means, you can manually
149 download the key with:
151 # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
153 Please verify the checksum afterwards:
156 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
157 acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
163 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
164 f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
170 // include note about older releases, but only for wiki
173 {pve} 5.x Repositories
174 ~~~~~~~~~~~~~~~~~~~~~~
176 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release
177 is out of date, and you should update your installation.
178 Nevertheless, we still provide access to those repositories at our download
181 [width="100%",cols="<d,3m",options="header"]
182 |===========================================================
183 |Repository | sources.list entry
184 |{pve} 5.x Enterprise |
185 deb https://enterprise.proxmox.com/debian stretch pve-enterprise
186 |{pve} 5.x No-Subscription |
187 deb http://download.proxmox.com/debian stretch pve-no-subscription
189 deb http://download.proxmox.com/debian stretch pvetest
190 |===========================================================
193 {pve} 4.x Repositories
194 ~~~~~~~~~~~~~~~~~~~~~~
196 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this
197 release is out of date, and you should update your
198 installation. Nevertheless, we still provide access to those
199 repositories at our download servers.
201 [width="100%",cols="<d,3m",options="header"]
202 |===========================================================
203 |Repository | sources.list entry
204 |{pve} 4.x Enterprise |
205 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
206 |{pve} 4.x No-Subscription |
207 deb http://download.proxmox.com/debian jessie pve-no-subscription
209 deb http://download.proxmox.com/debian jessie pvetest
210 |===========================================================
213 {pve} 3.x Repositories
214 ~~~~~~~~~~~~~~~~~~~~~~
216 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this
217 release is out of date, and you should update your
218 installation. Nevertheless, we still provide access to those
219 repositories at our download servers.
221 [width="100%",cols="<d,3m",options="header"]
222 |===========================================================
223 |Repository | sources.list entry
224 |{pve} 3.x Enterprise |
225 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
226 |{pve} 3.x No-Subscription |
227 deb http://download.proxmox.com/debian wheezy pve-no-subscription
229 deb http://download.proxmox.com/debian wheezy pvetest
230 |===========================================================
233 Outdated: `stable` Repository `pve`
234 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
236 This repository is a leftover to easy the update to 3.1. It will not
237 get any updates after the release of 3.1. Therefore you need to remove
238 this repository after you upgraded to 3.1.
240 .File `/etc/apt/sources.list`
242 deb http://ftp.debian.org/debian wheezy main contrib
244 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
245 # deb http://download.proxmox.com/debian wheezy pve
248 deb http://security.debian.org/ wheezy/updates main contrib
252 Outdated: {pve} 2.x Repositories
253 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
255 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please
256 upgrade to latest version as soon as possible. In order to use the
257 stable `pve` 2.x repository, check your sources.list:
259 .File `/etc/apt/sources.list`
261 deb http://ftp.debian.org/debian squeeze main contrib
263 # PVE packages provided by proxmox.com
264 deb http://download.proxmox.com/debian squeeze pve
267 deb http://security.debian.org/ squeeze/updates main contrib
271 Outdated: {pve} VE 1.x Repositories
272 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
274 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please
275 upgrade to latest version as soon as possible.
280 include::pve-copyright.adoc[]