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