buildsys: switch upload dist over to buster
[pve-docs.git] / pve-package-repos.adoc
1 [[sysadmin_package_repositories]]
2 Package Repositories
3 --------------------
4 ifdef::wiki[]
5 :pve-toplevel:
6 endif::wiki[]
7
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.
14
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`.
20
21 .File `/etc/apt/sources.list`
22 ----
23 deb http://ftp.debian.org/debian stretch main contrib
24 deb http://ftp.debian.org/debian stretch-updates main contrib
25
26 # security updates
27 deb http://security.debian.org stretch/updates main contrib
28 ----
29
30 In addition, {pve} provides three different package repositories.
31
32 {pve} Enterprise Repository
33 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
34
35 This is the default, stable and recommended repository, available for
36 all {pve} subscription users. It contains the most stable packages,
37 and is suitable for production use. The `pve-enterprise` repository is
38 enabled by default:
39
40 .File `/etc/apt/sources.list.d/pve-enterprise.list`
41 ----
42 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
43 ----
44
45 As soon as updates are available, the `root@pam` user is notified via
46 email about the available new packages. On the GUI, the change-log of
47 each package can be viewed (if available), showing all details of the
48 update. So you will never miss important security fixes.
49
50 Please note that and you need a valid subscription key to access this
51 repository. We offer different support levels, and you can find further
52 details at https://www.proxmox.com/en/proxmox-ve/pricing.
53
54 NOTE: You can disable this repository by commenting out the above line
55 using a `#` (at the start of the line). This prevents error messages
56 if you do not have a subscription key. Please configure the
57 `pve-no-subscription` repository in that case.
58
59
60 {pve} No-Subscription Repository
61 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
62
63 As the name suggests, you do not need a subscription key to access
64 this repository. It can be used for testing and non-production
65 use. Its not recommended to run on production servers, as these
66 packages are not always heavily tested and validated.
67
68 We recommend to configure this repository in `/etc/apt/sources.list`.
69
70 .File `/etc/apt/sources.list`
71 ----
72 deb http://ftp.debian.org/debian stretch main contrib
73 deb http://ftp.debian.org/debian stretch-updates main contrib
74
75 # PVE pve-no-subscription repository provided by proxmox.com,
76 # NOT recommended for production use
77 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
78
79 # security updates
80 deb http://security.debian.org stretch/updates main contrib
81 ----
82
83
84 {pve} Test Repository
85 ~~~~~~~~~~~~~~~~~~~~~~
86
87 Finally, there is a repository called `pvetest`. This one contains the
88 latest packages and is heavily used by developers to test new
89 features. As usual, you can configure this using
90 `/etc/apt/sources.list` by adding the following line:
91
92 .sources.list entry for `pvetest`
93 ----
94 deb http://download.proxmox.com/debian/pve stretch pvetest
95 ----
96
97 WARNING: the `pvetest` repository should (as the name implies) only be used
98 for testing new features or bug fixes.
99
100 [[sysadmin_package_repositories_ceph]]
101 {pve} Ceph Repository
102 ~~~~~~~~~~~~~~~~~~~~~
103
104 This is {pve}'s main Ceph repository and holds the Ceph packages for
105 production use. You can also use this repository to update only the Ceph
106 client.
107
108 .File `/etc/apt/sources.list.d/ceph.list`
109 ----
110 deb http://download.proxmox.com/debian/ceph-luminous stretch main
111 ----
112
113
114 {pve} Ceph Testing Repository
115 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
116
117 This Ceph repository contains the Ceph packages before they are moved into the
118 main repository and is used to test new Ceph release on {pve}.
119
120 .File `/etc/apt/sources.list.d/ceph.list`
121 ----
122 deb http://download.proxmox.com/debian/ceph-luminous stretch test
123 ----
124
125
126 SecureApt
127 ~~~~~~~~~
128
129 We use GnuPG to sign the `Release` files inside those repositories,
130 and APT uses that signatures to verify that all packages are from a
131 trusted source.
132
133 The key used for verification is already installed if you install from
134 our installation CD. If you install by other means, you can manually
135 download the key with:
136
137  # wget http://download.proxmox.com/debian/proxmox-ve-release-5.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-5.x.gpg
138
139 Please verify the checksum afterwards:
140
141 ----
142 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-5.x.gpg
143 ffb95f0f4be68d2e753c8875ea2f8465864a58431d5361e88789568673551501ae574283a4e0492f17d79dc67edfb173a56a6304dea39e01f249ebdabc9f074a  /etc/apt/trusted.gpg.d/proxmox-ve-release-5.x.gpg
144 ----
145
146 or
147
148 ----
149 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-5.x.gpg
150 511d36d0f1350c01c42a3dc9f3c27939  /etc/apt/trusted.gpg.d/proxmox-ve-release-5.x.gpg
151 ----
152
153
154 ifdef::wiki[]
155
156 // include note about older releases, but only for wiki
157
158
159 {pve} 4.x Repositories
160 ~~~~~~~~~~~~~~~~~~~~~~
161
162 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this
163 release is out of date, and you should update your
164 installation. Nevertheless, we still provide access to those
165 repositories at our download servers.
166
167 [width="100%",cols="<d,3m",options="header"]
168 |===========================================================
169 |Repository                 | sources.list entry
170 |{pve} 4.x Enterprise       |
171 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
172 |{pve} 4.x No-Subscription  |
173 deb http://download.proxmox.com/debian jessie pve-no-subscription
174 |{pve} 4.x Test             |
175 deb http://download.proxmox.com/debian jessie pvetest
176 |===========================================================
177
178
179 {pve} 3.x Repositories
180 ~~~~~~~~~~~~~~~~~~~~~~
181
182 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this
183 release is out of date, and you should update your
184 installation. Nevertheless, we still provide access to those
185 repositories at our download servers.
186
187 [width="100%",cols="<d,3m",options="header"]
188 |===========================================================
189 |Repository                 | sources.list entry
190 |{pve} 3.x Enterprise       |
191 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
192 |{pve} 3.x No-Subscription  |
193 deb http://download.proxmox.com/debian wheezy pve-no-subscription
194 |{pve} 3.x Test             |
195 deb http://download.proxmox.com/debian wheezy pvetest
196 |===========================================================
197
198
199 Outdated: `stable` Repository `pve`
200 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
201
202 This repository is a leftover to easy the update to 3.1. It will not
203 get any updates after the release of 3.1. Therefore you need to remove
204 this repository after you upgraded to 3.1.
205
206 .File `/etc/apt/sources.list`
207 ----
208 deb http://ftp.debian.org/debian wheezy main contrib
209
210 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
211 # deb http://download.proxmox.com/debian wheezy pve
212
213 # security updates
214 deb http://security.debian.org/ wheezy/updates main contrib
215 ----
216
217
218 Outdated: {pve} 2.x Repositories
219 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
220
221 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please
222 upgrade to latest version as soon as possible. In order to use the
223 stable `pve` 2.x repository, check your sources.list:
224
225 .File `/etc/apt/sources.list`
226 ----
227 deb http://ftp.debian.org/debian squeeze main contrib
228
229 # PVE packages provided by proxmox.com
230 deb http://download.proxmox.com/debian squeeze pve
231
232 # security updates
233 deb http://security.debian.org/ squeeze/updates main contrib
234 ----
235
236
237 Outdated: {pve} VE 1.x Repositories
238 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
239
240 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please
241 upgrade to latest version as soon as possible.
242
243
244 endif::wiki[]
245 ifdef::manvolnum[]
246 include::pve-copyright.adoc[]
247 endif::manvolnum[]