pve-package-repos.adoc

   1 [[sysadmin_package_repositories]]
   2 Package Repositories
   3 --------------------
   4 ifdef::wiki[]
   5 :pve-toplevel:
   6 endif::wiki[]
   7
   8 All Debian based systems use
   9 http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as package
  10 management tool. The list of repositories is defined in
  11 `/etc/apt/sources.list` and `.list` files found inside
  12 `/etc/apt/sources.d/`. Updates can be installed directly using
  13 `apt-get`, or via the GUI.
  14
  15 Apt `sources.list` files list one package repository per line, with
  16 the most preferred source listed first. Empty lines are ignored, and a
  17 `#` character anywhere on a line marks the remainder of that line as a
  18 comment. The information available from the configured sources is
  19 acquired by `apt-get update`.
  20
  21 .File `/etc/apt/sources.list`
  22 ----
  23 deb http://ftp.debian.org/debian buster main contrib
  24 deb http://ftp.debian.org/debian buster-updates main contrib
  25
  26 # security updates
  27 deb http://security.debian.org/debian-security buster/updates main contrib
  28 ----
  29 // FIXME for 7.0: change security update suite to bullseye-security
  30
  31 In addition, {pve} provides three different package repositories.
  32
  33 [[sysadmin_enterprise_repo]]
  34 {pve} Enterprise Repository
  35 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  36
  37 This is the default, stable and recommended repository, available for
  38 all {pve} subscription users. It contains the most stable packages,
  39 and is suitable for production use. The `pve-enterprise` repository is
  40 enabled by default:
  41
  42 .File `/etc/apt/sources.list.d/pve-enterprise.list`
  43 ----
  44 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
  45 ----
  46
  47 As soon as updates are available, the `root@pam` user is notified via
  48 email about the available new packages. On the GUI, the change-log of
  49 each package can be viewed (if available), showing all details of the
  50 update. So you will never miss important security fixes.
  51
  52 Please note that you need a valid subscription key to access this
  53 repository. We offer different support levels, and you can find further
  54 details at https://www.proxmox.com/en/proxmox-ve/pricing.
  55
  56 NOTE: You can disable this repository by commenting out the above line
  57 using a `#` (at the start of the line). This prevents error messages
  58 if you do not have a subscription key. Please configure the
  59 `pve-no-subscription` repository in that case.
  60
  61
  62 [[sysadmin_no_subscription_repo]]
  63 {pve} No-Subscription Repository
  64 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  65
  66 As the name suggests, you do not need a subscription key to access
  67 this repository. It can be used for testing and non-production
  68 use. Its not recommended to run on production servers, as these
  69 packages are not always heavily tested and validated.
  70
  71 We recommend to configure this repository in `/etc/apt/sources.list`.
  72
  73 .File `/etc/apt/sources.list`
  74 ----
  75 deb http://ftp.debian.org/debian buster main contrib
  76 deb http://ftp.debian.org/debian buster-updates main contrib
  77
  78 # PVE pve-no-subscription repository provided by proxmox.com,
  79 # NOT recommended for production use
  80 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
  81
  82 # security updates
  83 deb http://security.debian.org/debian-security buster/updates main contrib
  84 ----
  85
  86
  87 [[sysadmin_test_repo]]
  88 {pve} Test Repository
  89 ~~~~~~~~~~~~~~~~~~~~~~
  90
  91 Finally, there is a repository called `pvetest`. This one contains the
  92 latest packages and is heavily used by developers to test new
  93 features. As usual, you can configure this using
  94 `/etc/apt/sources.list` by adding the following line:
  95
  96 .sources.list entry for `pvetest`
  97 ----
  98 deb http://download.proxmox.com/debian/pve buster pvetest
  99 ----
 100
 101 WARNING: the `pvetest` repository should (as the name implies) only be used
 102 for testing new features or bug fixes.
 103
 104 [[sysadmin_package_repositories_ceph]]
 105 {pve} Ceph Repository
 106 ~~~~~~~~~~~~~~~~~~~~~
 107
 108 This is {pve}'s main Ceph repository and holds the Ceph packages for
 109 production use. You can also use this repository to update only the Ceph
 110 client.
 111
 112 .File `/etc/apt/sources.list.d/ceph.list`
 113 ----
 114 deb http://download.proxmox.com/debian/ceph-nautilus buster main
 115 ----
 116
 117
 118 {pve} Ceph Testing Repository
 119 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 120
 121 This Ceph repository contains the Ceph packages before they are moved into the
 122 main repository and is used to test new Ceph release on {pve}.
 123
 124 .File `/etc/apt/sources.list.d/ceph.list`
 125 ----
 126 deb http://download.proxmox.com/debian/ceph-nautilus buster test
 127 ----
 128
 129 {pve} Ceph Luminous Repository For Upgrade
 130 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 131
 132 This is a build of tje Ceph Luminous release for {pve} 6.0, this can be used to
 133 upgrade a {pve} cluster with Ceph Luminous deployed first to our 6.0 release,
 134 based on Debian Buster, and only afterwards upgrade the Ceph on it's own.
 135
 136 .File `/etc/apt/sources.list.d/ceph.list`
 137 ----
 138 deb http://download.proxmox.com/debian/ceph-luminous buster main
 139 ----
 140
 141 SecureApt
 142 ~~~~~~~~~
 143
 144 We use GnuPG to sign the `Release` files inside those repositories,
 145 and APT uses that signatures to verify that all packages are from a
 146 trusted source.
 147
 148 The key used for verification is already installed if you install from
 149 our installation CD. If you install by other means, you can manually
 150 download the key with:
 151
 152  # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 153
 154 Please verify the checksum afterwards:
 155
 156 ----
 157 # sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 158 acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 159 ----
 160
 161 or
 162
 163 ----
 164 # md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 165 f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg
 166 ----
 167
 168
 169 ifdef::wiki[]
 170
 171 // include note about older releases, but only for wiki
 172
 173
 174 {pve} 5.x Repositories
 175 ~~~~~~~~~~~~~~~~~~~~~~
 176
 177 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release
 178 is out of date, and you should update your installation.
 179 Nevertheless, we still provide access to those repositories at our download
 180 servers.
 181
 182 [width="100%",cols="<d,3m",options="header"]
 183 |===========================================================
 184 |Repository                 | sources.list entry
 185 |{pve} 5.x Enterprise       |
 186 deb https://enterprise.proxmox.com/debian stretch pve-enterprise
 187 |{pve} 5.x No-Subscription  |
 188 deb http://download.proxmox.com/debian stretch pve-no-subscription
 189 |{pve} 5.x Test             |
 190 deb http://download.proxmox.com/debian stretch pvetest
 191 |===========================================================
 192
 193
 194 {pve} 4.x Repositories
 195 ~~~~~~~~~~~~~~~~~~~~~~
 196
 197 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this
 198 release is out of date, and you should update your
 199 installation. Nevertheless, we still provide access to those
 200 repositories at our download servers.
 201
 202 [width="100%",cols="<d,3m",options="header"]
 203 |===========================================================
 204 |Repository                 | sources.list entry
 205 |{pve} 4.x Enterprise       |
 206 deb https://enterprise.proxmox.com/debian jessie pve-enterprise
 207 |{pve} 4.x No-Subscription  |
 208 deb http://download.proxmox.com/debian jessie pve-no-subscription
 209 |{pve} 4.x Test             |
 210 deb http://download.proxmox.com/debian jessie pvetest
 211 |===========================================================
 212
 213
 214 {pve} 3.x Repositories
 215 ~~~~~~~~~~~~~~~~~~~~~~
 216
 217 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this
 218 release is out of date, and you should update your
 219 installation. Nevertheless, we still provide access to those
 220 repositories at our download servers.
 221
 222 [width="100%",cols="<d,3m",options="header"]
 223 |===========================================================
 224 |Repository                 | sources.list entry
 225 |{pve} 3.x Enterprise       |
 226 deb https://enterprise.proxmox.com/debian wheezy pve-enterprise
 227 |{pve} 3.x No-Subscription  |
 228 deb http://download.proxmox.com/debian wheezy pve-no-subscription
 229 |{pve} 3.x Test             |
 230 deb http://download.proxmox.com/debian wheezy pvetest
 231 |===========================================================
 232
 233
 234 Outdated: `stable` Repository `pve`
 235 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 236
 237 This repository is a leftover to easy the update to 3.1. It will not
 238 get any updates after the release of 3.1. Therefore you need to remove
 239 this repository after you upgraded to 3.1.
 240
 241 .File `/etc/apt/sources.list`
 242 ----
 243 deb http://ftp.debian.org/debian wheezy main contrib
 244
 245 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
 246 # deb http://download.proxmox.com/debian wheezy pve
 247
 248 # security updates
 249 deb http://security.debian.org/ wheezy/updates main contrib
 250 ----
 251
 252
 253 Outdated: {pve} 2.x Repositories
 254 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 255
 256 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please
 257 upgrade to latest version as soon as possible. In order to use the
 258 stable `pve` 2.x repository, check your sources.list:
 259
 260 .File `/etc/apt/sources.list`
 261 ----
 262 deb http://ftp.debian.org/debian squeeze main contrib
 263
 264 # PVE packages provided by proxmox.com
 265 deb http://download.proxmox.com/debian squeeze pve
 266
 267 # security updates
 268 deb http://security.debian.org/ squeeze/updates main contrib
 269 ----
 270
 271
 272 Outdated: {pve} VE 1.x Repositories
 273 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 274
 275 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please
 276 upgrade to latest version as soon as possible.
 277
 278
 279 endif::wiki[]
 280 ifdef::manvolnum[]
 281 include::pve-copyright.adoc[]
 282 endif::manvolnum[]