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