]>
Commit | Line | Data |
---|---|---|
80c0adcb | 1 | [[sysadmin_package_repositories]] |
d91f8c1e DM |
2 | Package Repositories |
3 | -------------------- | |
5f09af76 DM |
4 | ifdef::wiki[] |
5 | :pve-toplevel: | |
6 | endif::wiki[] | |
7 | ||
8e2aabac | 8 | {pve} uses http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as its |
d9beb571 | 9 | package management tool like any other Debian-based system. |
8e2aabac | 10 | |
0d425d9d CH |
11 | {pve} automatically checks for package updates on a daily basis. The `root@pam` |
12 | user is notified via email about available updates. From the GUI, the | |
13 | 'Changelog' button can be used to see more details about an selected update. | |
14 | ||
d9beb571 TL |
15 | Repositories in {pve} |
16 | ~~~~~~~~~~~~~~~~~~~~~ | |
17 | ||
18 | Repositories are a collection of software packages, they can be used to install | |
19 | new software, but are also important to get new updates. | |
20 | ||
21 | NOTE: You need valid Debian and Proxmox repositories to get the latest | |
22 | security updates, bug fixes and new features. | |
23 | ||
24 | APT Repositories are defined in the file `/etc/apt/sources.list` and in `.list` | |
25 | files placed in `/etc/apt/sources.list.d/`. | |
26 | ||
27 | Repository Management | |
28 | ^^^^^^^^^^^^^^^^^^^^^ | |
29 | ||
30 | [thumbnail="screenshot/gui-node-repositories.png"] | |
31 | ||
1f241093 | 32 | Since Proxmox VE 7, you can check the repository state in the web interface. |
d9beb571 TL |
33 | The node summary panel shows a high level status overview, while the separate |
34 | 'Repository' panel shows in-depth status and list of all configured | |
35 | repositories. | |
36 | ||
37 | Basic repository management, for example, activating or deactivating a | |
38 | repository, is also supported. | |
39 | ||
40 | Sources.list | |
41 | ^^^^^^^^^^^^ | |
42 | ||
43 | In a `sources.list` file, each line defines a package repository. The preferred | |
44 | source must come first. Empty lines are ignored. A `#` character anywhere on a | |
45 | line marks the remainder of that line as a comment. The available packages from | |
46 | a repository are acquired by running `apt-get update`. Updates can be installed | |
47 | directly using `apt-get`, or via the GUI (Node -> Updates). | |
d91f8c1e | 48 | |
8c1189b6 | 49 | .File `/etc/apt/sources.list` |
d91f8c1e | 50 | ---- |
1f241093 TL |
51 | deb http://deb.debian.org/debian bookworm main contrib |
52 | deb http://deb.debian.org/debian bookworm-updates main contrib | |
d91f8c1e DM |
53 | |
54 | # security updates | |
1f241093 | 55 | deb http://security.debian.org/debian-security bookworm-security main contrib |
d91f8c1e DM |
56 | ---- |
57 | ||
d9beb571 | 58 | {pve} provides three different package repositories. |
d91f8c1e | 59 | |
33e0c965 | 60 | [[sysadmin_enterprise_repo]] |
d91f8c1e DM |
61 | {pve} Enterprise Repository |
62 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
63 | ||
0d425d9d CH |
64 | This is the recommended repository and available for all {pve} subscription |
65 | users. It contains the most stable packages and is suitable for production use. | |
66 | The `pve-enterprise` repository is enabled by default: | |
d91f8c1e | 67 | |
8c1189b6 | 68 | .File `/etc/apt/sources.list.d/pve-enterprise.list` |
d91f8c1e | 69 | ---- |
1f241093 | 70 | deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise |
d91f8c1e DM |
71 | ---- |
72 | ||
0d425d9d CH |
73 | Please note that you need a valid subscription key to access the |
74 | `pve-enterprise` repository. We offer different support levels, which you can | |
75 | find further details about at {pricing-url}. | |
d91f8c1e | 76 | |
8e2aabac | 77 | NOTE: You can disable this repository by commenting out the above line using a |
1f241093 TL |
78 | `#` (at the start of the line). This prevents error messages if your host does |
79 | not have a subscription key. Please configure the `pve-no-subscription` | |
80 | repository in that case. | |
d91f8c1e | 81 | |
33e0c965 | 82 | [[sysadmin_no_subscription_repo]] |
d91f8c1e DM |
83 | {pve} No-Subscription Repository |
84 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
85 | ||
0d425d9d CH |
86 | As the name suggests, you do not need a subscription key to access |
87 | this repository. It can be used for testing and non-production | |
88 | use. It's not recommended to use this on production servers, as these | |
89 | packages are not always as heavily tested and validated. | |
d91f8c1e | 90 | |
8c1189b6 | 91 | We recommend to configure this repository in `/etc/apt/sources.list`. |
d91f8c1e | 92 | |
8c1189b6 | 93 | .File `/etc/apt/sources.list` |
d91f8c1e | 94 | ---- |
1f241093 TL |
95 | deb http://ftp.debian.org/debian bookworm main contrib |
96 | deb http://ftp.debian.org/debian bookworm-updates main contrib | |
d91f8c1e | 97 | |
363c7a1d | 98 | # Proxmox VE pve-no-subscription repository provided by proxmox.com, |
d91f8c1e | 99 | # NOT recommended for production use |
1f241093 | 100 | deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription |
d91f8c1e DM |
101 | |
102 | # security updates | |
1f241093 | 103 | deb http://security.debian.org/debian-security bookworm-security main contrib |
d91f8c1e DM |
104 | ---- |
105 | ||
9dfb9a99 | 106 | |
33e0c965 | 107 | [[sysadmin_test_repo]] |
d91f8c1e DM |
108 | {pve} Test Repository |
109 | ~~~~~~~~~~~~~~~~~~~~~~ | |
110 | ||
8e2aabac AL |
111 | This repository contains the latest packages and is primarily used by developers |
112 | to test new features. To configure it, add the following line to | |
f8a257d9 | 113 | `/etc/apt/sources.list`: |
d91f8c1e DM |
114 | |
115 | .sources.list entry for `pvetest` | |
116 | ---- | |
1f241093 | 117 | deb http://download.proxmox.com/debian/pve bookworm pvetest |
d91f8c1e DM |
118 | ---- |
119 | ||
8e2aabac AL |
120 | WARNING: The `pvetest` repository should (as the name implies) only be used for |
121 | testing new features or bug fixes. | |
b4a65355 | 122 | |
2ecb5f80 | 123 | [[sysadmin_package_repositories_ceph]] |
a90b75d5 TL |
124 | Ceph Reef Enterprise Repository |
125 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
126 | ||
127 | This repository holds the enterprise {pve} Ceph 18.2 Reef packages. They are | |
128 | suitable for production. Use this repository if you run the Ceph client or a | |
129 | full Ceph cluster on {pve}. | |
130 | ||
131 | .File `/etc/apt/sources.list.d/ceph.list` | |
132 | ---- | |
133 | deb https://enterprise.proxmox.com/debian/ceph-reef bookworm enterprise | |
134 | ---- | |
135 | ||
136 | ||
137 | Ceph Reef No-Subscription Repository | |
138 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
139 | ||
140 | This Ceph repository contains the Ceph 18.2 Reef packages before they are moved | |
141 | to the enterprise repository and after they where on the test repository. | |
142 | ||
143 | NOTE: It's recommended to use the enterprise repository for production | |
144 | machines. | |
145 | ||
146 | .File `/etc/apt/sources.list.d/ceph.list` | |
147 | ---- | |
148 | deb http://download.proxmox.com/debian/ceph-reef bookworm no-subscription | |
149 | ---- | |
150 | ||
151 | ||
152 | Ceph Reef Test Repository | |
153 | ~~~~~~~~~~~~~~~~~~~~~~~~~ | |
154 | ||
155 | This Ceph repository contains the Ceph 18.2 Reef packages before they are moved | |
156 | to the main repository. It is used to test new Ceph releases on {pve}. | |
157 | ||
158 | .File `/etc/apt/sources.list.d/ceph.list` | |
159 | ---- | |
160 | deb http://download.proxmox.com/debian/ceph-reef bookworm test | |
161 | ---- | |
162 | ||
1f241093 | 163 | Ceph Quincy Enterprise Repository |
cf50cfe6 | 164 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
f211eb8c | 165 | |
1f241093 TL |
166 | This repository holds the enterprise {pve} Ceph Quincy packages. They are |
167 | suitable for production. Use this repository if you run the Ceph client or a | |
168 | full Ceph cluster on {pve}. | |
f211eb8c TL |
169 | |
170 | .File `/etc/apt/sources.list.d/ceph.list` | |
171 | ---- | |
0016162f | 172 | deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise |
f211eb8c TL |
173 | ---- |
174 | ||
175 | ||
1f241093 TL |
176 | Ceph Quincy No-Subscription Repository |
177 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
f211eb8c TL |
178 | |
179 | This Ceph repository contains the Ceph Quincy packages before they are moved | |
1f241093 | 180 | to the enterprise repository and after they where on the test repository. |
b9495945 | 181 | |
1f241093 TL |
182 | NOTE: It's recommended to use the enterprise repository for production |
183 | machines. | |
b9495945 TL |
184 | |
185 | .File `/etc/apt/sources.list.d/ceph.list` | |
186 | ---- | |
1f241093 | 187 | deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription |
b9495945 TL |
188 | ---- |
189 | ||
190 | ||
1f241093 TL |
191 | Ceph Quincy Test Repository |
192 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
b9495945 | 193 | |
1f241093 | 194 | This Ceph repository contains the Ceph Quincy packages before they are moved |
792c2bcb | 195 | to the main repository. It is used to test new Ceph releases on {pve}. |
b9495945 TL |
196 | |
197 | .File `/etc/apt/sources.list.d/ceph.list` | |
198 | ---- | |
1f241093 | 199 | deb http://download.proxmox.com/debian/ceph-quincy bookworm test |
b9495945 TL |
200 | ---- |
201 | ||
1f241093 | 202 | Older Ceph Repositories |
792c2bcb | 203 | ~~~~~~~~~~~~~~~~~~~~~~~ |
b9495945 | 204 | |
1f241093 TL |
205 | {pve} 8 doesn't support Ceph Pacific, Ceph Octopus, or even older releases for |
206 | hyper-converged setups. For those releases, you need to first upgrade Ceph to a | |
207 | newer release before upgrading to Proxmox VE 8. | |
2ecb5f80 | 208 | |
1f241093 TL |
209 | See the respective |
210 | https://pve.proxmox.com/wiki/Category:Ceph_Upgrade[upgrade guide] for details. | |
792c2bcb | 211 | |
f1a72f87 | 212 | |
48ae5721 AZ |
213 | [[sysadmin_debian_firmware_repo]] |
214 | Debian Firmware Repository | |
215 | ~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
216 | ||
217 | Starting with Debian Bookworm ({pve} 8) non-free firmware (as defined by | |
218 | https://www.debian.org/social_contract#guidelines[DFSG]) has been moved to the | |
219 | newly created Debian repository component `non-free-firmware`. | |
220 | ||
221 | Enable this repository if you want to set up | |
222 | xref:sysadmin_firmware_cpu[Early OS Microcode Updates] or need additional | |
223 | xref:sysadmin_firmware_runtime_files[Runtime Firmware Files] not already | |
224 | included in the pre-installed package `pve-firmware`. | |
225 | ||
226 | To be able to install packages from this component, run | |
227 | `editor /etc/apt/sources.list`, append `non-free-firmware` to the end of each | |
228 | `.debian.org` repository line and run `apt update`. | |
229 | ||
230 | ||
d9beb571 TL |
231 | [[repos_secure_apt]] |
232 | ||
25663707 DM |
233 | SecureApt |
234 | ~~~~~~~~~ | |
235 | ||
8e2aabac AL |
236 | The 'Release' files in the repositories are signed with GnuPG. APT is using |
237 | these signatures to verify that all packages are from a trusted source. | |
238 | ||
239 | If you install {pve} from an official ISO image, the key for verification is | |
240 | already installed. | |
25663707 | 241 | |
8e2aabac AL |
242 | If you install {pve} on top of Debian, download and install |
243 | the key with the following commands: | |
25663707 | 244 | |
8e2aabac | 245 | ---- |
1f241093 | 246 | # wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg |
8e2aabac | 247 | ---- |
25663707 | 248 | |
4fcbd78d | 249 | Verify the checksum afterwards with the `sha512sum` CLI tool: |
25663707 | 250 | |
b31e0578 | 251 | ---- |
1f241093 TL |
252 | # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg |
253 | 7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87 /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg | |
b31e0578 DM |
254 | ---- |
255 | ||
4fcbd78d | 256 | or the `md5sum` CLI tool: |
b31e0578 | 257 | |
25663707 | 258 | ---- |
1f241093 TL |
259 | # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg |
260 | 41558dc019ef90bd0f6067644a51cf5b /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg | |
25663707 DM |
261 | ---- |
262 | ||
25663707 | 263 | |
f1a72f87 DM |
264 | ifdef::wiki[] |
265 | ||
266 | // include note about older releases, but only for wiki | |
267 | ||
1f241093 TL |
268 | {pve} 7.x Repositories |
269 | ~~~~~~~~~~~~~~~~~~~~~~ | |
270 | ||
271 | {pve} 7.x is based on Debian 11.x (``bullseye''). Please note that this release | |
272 | is out of date (see the xref:faq-support-table[FAQ support table]). Existing | |
273 | installations should be updated. Nevertheless access to these repositories is | |
274 | still provided. | |
275 | ||
276 | [width="100%",cols="<d,3m",options="header"] | |
277 | |=========================================================== | |
278 | |Repository | sources.list entry | |
279 | |{pve} 7.x Enterprise | | |
280 | deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise | |
281 | |{pve} 7.x No-Subscription | | |
282 | deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription | |
283 | |{pve} 7.x Test | | |
284 | deb http://download.proxmox.com/debian/pve bullseye pvetest | |
285 | |=========================================================== | |
286 | ||
287 | Release key URL: https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg | |
288 | ||
289 | Release key hash sums: | |
290 | ||
291 | ---- | |
292 | sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg | |
293 | 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa | |
294 | ||
295 | md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg | |
296 | bcc35c7173e0845c0d6ad6470b70f50e | |
297 | ---- | |
298 | ||
20dafeb0 | 299 | |
792c2bcb TL |
300 | {pve} 6.x Repositories |
301 | ~~~~~~~~~~~~~~~~~~~~~~ | |
302 | ||
303 | {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is | |
304 | out of date. Existing installations should be updated. Nevertheless access to | |
305 | these repositories is still provided. | |
306 | ||
307 | [width="100%",cols="<d,3m",options="header"] | |
308 | |=========================================================== | |
309 | |Repository | sources.list entry | |
310 | |{pve} 6.x Enterprise | | |
17597194 | 311 | deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise |
792c2bcb | 312 | |{pve} 6.x No-Subscription | |
17597194 | 313 | deb http://download.proxmox.com/debian/pve buster pve-no-subscription |
792c2bcb | 314 | |{pve} 6.x Test | |
17597194 | 315 | deb http://download.proxmox.com/debian/pve buster pvetest |
792c2bcb TL |
316 | |=========================================================== |
317 | ||
318 | ||
f193440f TL |
319 | {pve} 5.x Repositories |
320 | ~~~~~~~~~~~~~~~~~~~~~~ | |
321 | ||
8e2aabac AL |
322 | {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is |
323 | out of date. Existing installations should be updated. Nevertheless access to | |
324 | these repositories is still provided. | |
f193440f TL |
325 | |
326 | [width="100%",cols="<d,3m",options="header"] | |
327 | |=========================================================== | |
328 | |Repository | sources.list entry | |
329 | |{pve} 5.x Enterprise | | |
17597194 | 330 | deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise |
f193440f | 331 | |{pve} 5.x No-Subscription | |
17597194 | 332 | deb http://download.proxmox.com/debian/pve stretch pve-no-subscription |
f193440f | 333 | |{pve} 5.x Test | |
17597194 | 334 | deb http://download.proxmox.com/debian/pve stretch pvetest |
f193440f TL |
335 | |=========================================================== |
336 | ||
337 | ||
20dafeb0 DM |
338 | {pve} 4.x Repositories |
339 | ~~~~~~~~~~~~~~~~~~~~~~ | |
340 | ||
8e2aabac AL |
341 | {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is |
342 | out of date. Existing installations should be updated. Nevertheless access to | |
343 | these repositories is still provided. | |
20dafeb0 DM |
344 | |
345 | [width="100%",cols="<d,3m",options="header"] | |
346 | |=========================================================== | |
347 | |Repository | sources.list entry | |
348 | |{pve} 4.x Enterprise | | |
17597194 | 349 | deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise |
20dafeb0 | 350 | |{pve} 4.x No-Subscription | |
17597194 | 351 | deb http://download.proxmox.com/debian/pve jessie pve-no-subscription |
20dafeb0 | 352 | |{pve} 4.x Test | |
17597194 | 353 | deb http://download.proxmox.com/debian/pve jessie pvetest |
20dafeb0 DM |
354 | |=========================================================== |
355 | ||
356 | ||
9dfb9a99 DM |
357 | {pve} 3.x Repositories |
358 | ~~~~~~~~~~~~~~~~~~~~~~ | |
f1a72f87 | 359 | |
8e2aabac AL |
360 | {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is |
361 | out of date. Existing installations should be updated. Nevertheless access to | |
362 | these repositories is still provided. | |
f1a72f87 DM |
363 | |
364 | [width="100%",cols="<d,3m",options="header"] | |
365 | |=========================================================== | |
366 | |Repository | sources.list entry | |
367 | |{pve} 3.x Enterprise | | |
17597194 | 368 | deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise |
f1a72f87 | 369 | |{pve} 3.x No-Subscription | |
17597194 | 370 | deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription |
f1a72f87 | 371 | |{pve} 3.x Test | |
17597194 | 372 | deb http://download.proxmox.com/debian/pve wheezy pvetest |
f1a72f87 DM |
373 | |=========================================================== |
374 | ||
f1a72f87 | 375 | |
8c1189b6 | 376 | Outdated: `stable` Repository `pve` |
9dfb9a99 DM |
377 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
378 | ||
8e2aabac AL |
379 | This repository is a leftover to ease the update to 3.1. It will not get any |
380 | updates after the release of 3.1. Therefore the repository needs to be removed | |
381 | after the upgrade to 3.1. | |
9dfb9a99 | 382 | |
8c1189b6 | 383 | .File `/etc/apt/sources.list` |
9dfb9a99 DM |
384 | ---- |
385 | deb http://ftp.debian.org/debian wheezy main contrib | |
386 | ||
387 | # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1 | |
388 | # deb http://download.proxmox.com/debian wheezy pve | |
389 | ||
390 | # security updates | |
391 | deb http://security.debian.org/ wheezy/updates main contrib | |
392 | ---- | |
393 | ||
394 | ||
395 | Outdated: {pve} 2.x Repositories | |
396 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
397 | ||
8e2aabac AL |
398 | {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to |
399 | the latest version as soon as possible. In order to use the stable `pve` 2.x | |
400 | repository, check your sources.list: | |
9dfb9a99 | 401 | |
8c1189b6 | 402 | .File `/etc/apt/sources.list` |
9dfb9a99 DM |
403 | ---- |
404 | deb http://ftp.debian.org/debian squeeze main contrib | |
405 | ||
406 | # PVE packages provided by proxmox.com | |
407 | deb http://download.proxmox.com/debian squeeze pve | |
408 | ||
409 | # security updates | |
410 | deb http://security.debian.org/ squeeze/updates main contrib | |
411 | ---- | |
412 | ||
413 | ||
414 | Outdated: {pve} VE 1.x Repositories | |
415 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
416 | ||
d3e2455a AL |
417 | {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade |
418 | to latest version as soon as possible. | |
9dfb9a99 DM |
419 | |
420 | ||
f1a72f87 | 421 | endif::wiki[] |
2ecb5f80 AA |
422 | ifdef::manvolnum[] |
423 | include::pve-copyright.adoc[] | |
424 | endif::manvolnum[] |