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
  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 buster pve-enterprise
  43 ----
  44
  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.
  47
  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.
  51
  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.
  56
  57 [[sysadmin_no_subscription_repo]]
  58 {pve} No-Subscription Repository
  59 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  60
  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.
  64
  65 We recommend to configure this repository in `/etc/apt/sources.list`.
  66
  67 .File `/etc/apt/sources.list`
  68 ----
  69 deb http://ftp.debian.org/debian buster main contrib
  70 deb http://ftp.debian.org/debian buster-updates main contrib
  71
  72 # PVE pve-no-subscription repository provided by proxmox.com,
  73 # NOT recommended for production use
  74 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
  75
  76 # security updates
  77 deb http://security.debian.org/debian-security buster/updates main contrib
  78 ----
  79
  80
  81 [[sysadmin_test_repo]]
  82 {pve} Test Repository
  83 ~~~~~~~~~~~~~~~~~~~~~~
  84
  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`:
  88
  89 .sources.list entry for `pvetest`
  90 ----
  91 deb http://download.proxmox.com/debian/pve buster pvetest
  92 ----
  93
  94 WARNING: The `pvetest` repository should (as the name implies) only be used for
  95 testing new features or bug fixes.
  96
  97 [[sysadmin_package_repositories_ceph]]
  98 {pve} Ceph Repository
  99 ~~~~~~~~~~~~~~~~~~~~~
 100
 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}.
 104
 105 .File `/etc/apt/sources.list.d/ceph.list`
 106 ----
 107 deb http://download.proxmox.com/debian/ceph-nautilus buster main
 108 ----
 109
 110
 111 {pve} Ceph Testing Repository
 112 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 113
 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}.
 116
 117 .File `/etc/apt/sources.list.d/ceph.list`
 118 ----
 119 deb http://download.proxmox.com/debian/ceph-nautilus buster test
 120 ----
 121
 122 {pve} Ceph Luminous Repository For Upgrade
 123 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 124
 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.
 131
 132 .File `/etc/apt/sources.list.d/ceph.list`
 133 ----
 134 deb http://download.proxmox.com/debian/ceph-luminous buster main
 135 ----
 136
 137 SecureApt
 138 ~~~~~~~~~
 139
 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.
 145
 146 If you install {pve} on top of Debian, download and install
 147 the key with the following commands:
 148
 149 ----
 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
 151 ----
 152
 153 Verify the checksum afterwards with:
 154
 155 ----
 156 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 157 ----
 158
 159 The output should be:
 160
 161 ----
 162 acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 163 ----
 164
 165 or:
 166
 167 ----
 168 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 169 ----
 170 The output should be:
 171
 172 ----
 173 f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 174 ----
 175
 176
 177 ifdef::wiki[]
 178
 179 // include note about older releases, but only for wiki
 180
 181
 182 {pve} 5.x Repositories
 183 ~~~~~~~~~~~~~~~~~~~~~~
 184
 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.
 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
 201 {pve} 4.x Repositories
 202 ~~~~~~~~~~~~~~~~~~~~~~
 203
 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.
 207
 208 [width="100%",cols="<d,3m",options="header"]
 209 |===========================================================
 210 |Repository                 | sources.list entry
 211 |{pve} 4.x Enterprise       |
 212 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
 213 |{pve} 4.x No-Subscription  |
 214 deb http://download.proxmox.com/debian jessie pve-no-subscription
 215 |{pve} 4.x Test             |
 216 deb http://download.proxmox.com/debian jessie pvetest
 217 |===========================================================
 218
 219
 220 {pve} 3.x Repositories
 221 ~~~~~~~~~~~~~~~~~~~~~~
 222
 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.
 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
 238
 239 Outdated: `stable` Repository `pve`
 240 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 241
 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.
 245
 246 .File `/etc/apt/sources.list`
 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
 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:
 264
 265 .File `/etc/apt/sources.list`
 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
 280 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please
 281 upgrade to latest version as soon as possible.
 282
 283
 284 endif::wiki[]
 285 ifdef::manvolnum[]
 286 include::pve-copyright.adoc[]
 287 endif::manvolnum[]