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