]>
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 AL |
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/`. | |
12 | ||
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`, | |
17 | or via the GUI. | |
d91f8c1e | 18 | |
8c1189b6 | 19 | .File `/etc/apt/sources.list` |
d91f8c1e | 20 | ---- |
f193440f TL |
21 | deb http://ftp.debian.org/debian buster main contrib |
22 | deb http://ftp.debian.org/debian buster-updates main contrib | |
d91f8c1e DM |
23 | |
24 | # security updates | |
8282f55f | 25 | deb http://security.debian.org/debian-security buster/updates main contrib |
d91f8c1e | 26 | ---- |
8282f55f | 27 | // FIXME for 7.0: change security update suite to bullseye-security |
d91f8c1e | 28 | |
8e2aabac | 29 | {pve} additionally provides three different package repositories. |
d91f8c1e | 30 | |
33e0c965 | 31 | [[sysadmin_enterprise_repo]] |
d91f8c1e DM |
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, | |
f1a72f87 DM |
37 | and is suitable for production use. The `pve-enterprise` repository is |
38 | enabled by default: | |
d91f8c1e | 39 | |
8c1189b6 | 40 | .File `/etc/apt/sources.list.d/pve-enterprise.list` |
d91f8c1e | 41 | ---- |
f193440f | 42 | deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise |
d91f8c1e DM |
43 | ---- |
44 | ||
8e2aabac AL |
45 | The `root@pam` user is notified via email about available updates. Click the |
46 | 'Changelog' button in the GUI to see more details about the selected update. | |
f1a72f87 | 47 | |
8e2aabac AL |
48 | You need a valid subscription key to access the `pve-enterprise` repository. |
49 | Different support levels are available. Further details can be found at | |
50 | https://www.proxmox.com/en/proxmox-ve/pricing. | |
d91f8c1e | 51 | |
8e2aabac AL |
52 | NOTE: You can disable this repository by commenting out the above line using a |
53 | `#` (at the start of the line). This prevents error messages if you do not have | |
54 | a subscription key. Please configure the `pve-no-subscription` repository in | |
55 | that case. | |
d91f8c1e | 56 | |
33e0c965 | 57 | [[sysadmin_no_subscription_repo]] |
d91f8c1e DM |
58 | {pve} No-Subscription Repository |
59 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
60 | ||
8e2aabac AL |
61 | This is the recommended repository for testing and non-production use. Its |
62 | packages are not as heavily tested and validated. You don't need a subscription key | |
63 | to access the `pve-no-subscription` repository. | |
d91f8c1e | 64 | |
8c1189b6 | 65 | We recommend to configure this repository in `/etc/apt/sources.list`. |
d91f8c1e | 66 | |
8c1189b6 | 67 | .File `/etc/apt/sources.list` |
d91f8c1e | 68 | ---- |
f193440f TL |
69 | deb http://ftp.debian.org/debian buster main contrib |
70 | deb http://ftp.debian.org/debian buster-updates main contrib | |
d91f8c1e DM |
71 | |
72 | # PVE pve-no-subscription repository provided by proxmox.com, | |
73 | # NOT recommended for production use | |
f193440f | 74 | deb http://download.proxmox.com/debian/pve buster pve-no-subscription |
d91f8c1e DM |
75 | |
76 | # security updates | |
8282f55f | 77 | deb http://security.debian.org/debian-security buster/updates main contrib |
d91f8c1e DM |
78 | ---- |
79 | ||
9dfb9a99 | 80 | |
33e0c965 | 81 | [[sysadmin_test_repo]] |
d91f8c1e DM |
82 | {pve} Test Repository |
83 | ~~~~~~~~~~~~~~~~~~~~~~ | |
84 | ||
8e2aabac AL |
85 | This repository contains the latest packages and is primarily used by developers |
86 | to test new features. To configure it, add the following line to | |
87 | `etc/apt/sources.list`: | |
d91f8c1e DM |
88 | |
89 | .sources.list entry for `pvetest` | |
90 | ---- | |
f193440f | 91 | deb http://download.proxmox.com/debian/pve buster pvetest |
d91f8c1e DM |
92 | ---- |
93 | ||
8e2aabac AL |
94 | WARNING: The `pvetest` repository should (as the name implies) only be used for |
95 | testing new features or bug fixes. | |
b4a65355 | 96 | |
2ecb5f80 AA |
97 | [[sysadmin_package_repositories_ceph]] |
98 | {pve} Ceph Repository | |
99 | ~~~~~~~~~~~~~~~~~~~~~ | |
100 | ||
8e2aabac AL |
101 | This repository holds the main {pve} Ceph packages. They are suitable for |
102 | production. Use this repository if you run the Ceph client or a full Ceph | |
103 | cluster on {pve}. | |
2ecb5f80 AA |
104 | |
105 | .File `/etc/apt/sources.list.d/ceph.list` | |
106 | ---- | |
f193440f | 107 | deb http://download.proxmox.com/debian/ceph-nautilus buster main |
2ecb5f80 AA |
108 | ---- |
109 | ||
110 | ||
111 | {pve} Ceph Testing Repository | |
112 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
113 | ||
8e2aabac AL |
114 | This Ceph repository contains the Ceph packages before they are moved to the |
115 | main repository. It is used to test new Ceph releases on {pve}. | |
2ecb5f80 AA |
116 | |
117 | .File `/etc/apt/sources.list.d/ceph.list` | |
118 | ---- | |
f193440f | 119 | deb http://download.proxmox.com/debian/ceph-nautilus buster test |
2ecb5f80 AA |
120 | ---- |
121 | ||
f193440f TL |
122 | {pve} Ceph Luminous Repository For Upgrade |
123 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
124 | ||
8e2aabac AL |
125 | If Ceph is deployed this repository is needed for the upgrade from {pve} 5.x to |
126 | {pve} 6.0. It provides packages for the older Ceph Luminous release for {pve} | |
127 | 6.0. | |
128 | ||
129 | The https://pve.proxmox.com/wiki/Upgrade_from_5.x_to_6.0[Upgrade 5.x to 6.0] | |
130 | document explains how to use this repository in detail. | |
f193440f TL |
131 | |
132 | .File `/etc/apt/sources.list.d/ceph.list` | |
133 | ---- | |
134 | deb http://download.proxmox.com/debian/ceph-luminous buster main | |
135 | ---- | |
f1a72f87 | 136 | |
25663707 DM |
137 | SecureApt |
138 | ~~~~~~~~~ | |
139 | ||
8e2aabac AL |
140 | The 'Release' files in the repositories are signed with GnuPG. APT is using |
141 | these signatures to verify that all packages are from a trusted source. | |
142 | ||
143 | If you install {pve} from an official ISO image, the key for verification is | |
144 | already installed. | |
25663707 | 145 | |
8e2aabac AL |
146 | If you install {pve} on top of Debian, download and install |
147 | the key with the following commands: | |
25663707 | 148 | |
8e2aabac | 149 | ---- |
f193440f | 150 | # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg |
8e2aabac | 151 | ---- |
25663707 | 152 | |
8e2aabac | 153 | Verify the checksum afterwards with: |
25663707 | 154 | |
b31e0578 | 155 | ---- |
f193440f | 156 | # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg |
8e2aabac AL |
157 | ---- |
158 | ||
159 | The output should be: | |
160 | ||
161 | ---- | |
f193440f | 162 | acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg |
b31e0578 DM |
163 | ---- |
164 | ||
8e2aabac | 165 | or: |
b31e0578 | 166 | |
25663707 | 167 | ---- |
f193440f | 168 | # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg |
8e2aabac AL |
169 | ---- |
170 | The output should be: | |
171 | ||
172 | ---- | |
f193440f | 173 | f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg |
25663707 DM |
174 | ---- |
175 | ||
25663707 | 176 | |
f1a72f87 DM |
177 | ifdef::wiki[] |
178 | ||
179 | // include note about older releases, but only for wiki | |
180 | ||
20dafeb0 | 181 | |
f193440f TL |
182 | {pve} 5.x Repositories |
183 | ~~~~~~~~~~~~~~~~~~~~~~ | |
184 | ||
8e2aabac AL |
185 | {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is |
186 | out of date. Existing installations should be updated. Nevertheless access to | |
187 | these repositories is still provided. | |
f193440f TL |
188 | |
189 | [width="100%",cols="<d,3m",options="header"] | |
190 | |=========================================================== | |
191 | |Repository | sources.list entry | |
192 | |{pve} 5.x Enterprise | | |
193 | deb https://enterprise.proxmox.com/debian stretch pve-enterprise | |
194 | |{pve} 5.x No-Subscription | | |
195 | deb http://download.proxmox.com/debian stretch pve-no-subscription | |
196 | |{pve} 5.x Test | | |
197 | deb http://download.proxmox.com/debian stretch pvetest | |
198 | |=========================================================== | |
199 | ||
200 | ||
20dafeb0 DM |
201 | {pve} 4.x Repositories |
202 | ~~~~~~~~~~~~~~~~~~~~~~ | |
203 | ||
8e2aabac AL |
204 | {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is |
205 | out of date. Existing installations should be updated. Nevertheless access to | |
206 | these repositories is still provided. | |
20dafeb0 DM |
207 | |
208 | [width="100%",cols="<d,3m",options="header"] | |
209 | |=========================================================== | |
210 | |Repository | sources.list entry | |
211 | |{pve} 4.x Enterprise | | |
a5526e69 | 212 | deb https://enterprise.proxmox.com/debian jessie pve-enterprise |
20dafeb0 | 213 | |{pve} 4.x No-Subscription | |
a5526e69 | 214 | deb http://download.proxmox.com/debian jessie pve-no-subscription |
20dafeb0 | 215 | |{pve} 4.x Test | |
a5526e69 | 216 | deb http://download.proxmox.com/debian jessie pvetest |
20dafeb0 DM |
217 | |=========================================================== |
218 | ||
219 | ||
9dfb9a99 DM |
220 | {pve} 3.x Repositories |
221 | ~~~~~~~~~~~~~~~~~~~~~~ | |
f1a72f87 | 222 | |
8e2aabac AL |
223 | {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is |
224 | out of date. Existing installations should be updated. Nevertheless access to | |
225 | these repositories is still provided. | |
f1a72f87 DM |
226 | |
227 | [width="100%",cols="<d,3m",options="header"] | |
228 | |=========================================================== | |
229 | |Repository | sources.list entry | |
230 | |{pve} 3.x Enterprise | | |
231 | deb https://enterprise.proxmox.com/debian wheezy pve-enterprise | |
232 | |{pve} 3.x No-Subscription | | |
233 | deb http://download.proxmox.com/debian wheezy pve-no-subscription | |
234 | |{pve} 3.x Test | | |
235 | deb http://download.proxmox.com/debian wheezy pvetest | |
236 | |=========================================================== | |
237 | ||
f1a72f87 | 238 | |
8c1189b6 | 239 | Outdated: `stable` Repository `pve` |
9dfb9a99 DM |
240 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
241 | ||
8e2aabac AL |
242 | This repository is a leftover to ease the update to 3.1. It will not get any |
243 | updates after the release of 3.1. Therefore the repository needs to be removed | |
244 | after the upgrade to 3.1. | |
9dfb9a99 | 245 | |
8c1189b6 | 246 | .File `/etc/apt/sources.list` |
9dfb9a99 DM |
247 | ---- |
248 | deb http://ftp.debian.org/debian wheezy main contrib | |
249 | ||
250 | # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1 | |
251 | # deb http://download.proxmox.com/debian wheezy pve | |
252 | ||
253 | # security updates | |
254 | deb http://security.debian.org/ wheezy/updates main contrib | |
255 | ---- | |
256 | ||
257 | ||
258 | Outdated: {pve} 2.x Repositories | |
259 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
260 | ||
8e2aabac AL |
261 | {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to |
262 | the latest version as soon as possible. In order to use the stable `pve` 2.x | |
263 | repository, check your sources.list: | |
9dfb9a99 | 264 | |
8c1189b6 | 265 | .File `/etc/apt/sources.list` |
9dfb9a99 DM |
266 | ---- |
267 | deb http://ftp.debian.org/debian squeeze main contrib | |
268 | ||
269 | # PVE packages provided by proxmox.com | |
270 | deb http://download.proxmox.com/debian squeeze pve | |
271 | ||
272 | # security updates | |
273 | deb http://security.debian.org/ squeeze/updates main contrib | |
274 | ---- | |
275 | ||
276 | ||
277 | Outdated: {pve} VE 1.x Repositories | |
278 | ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
279 | ||
8c1189b6 | 280 | {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please |
9dfb9a99 DM |
281 | upgrade to latest version as soon as possible. |
282 | ||
283 | ||
f1a72f87 | 284 | endif::wiki[] |
2ecb5f80 AA |
285 | ifdef::manvolnum[] |
286 | include::pve-copyright.adoc[] | |
287 | endif::manvolnum[] |