pve-package-repos.adoc

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