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 Quincy Repository
 123 ~~~~~~~~~~~~~~~~~~~~~~
 124
 125 NOTE: Ceph Quincy (17.2) was declared stable with {pve} 7.3 or after using the
 126 Ceph 17.2.1 version.
 127
 128 This repository holds the main {pve} Ceph Quincy packages. They are suitable
 129 for production. Use this repository if you run the Ceph client or a full Ceph
 130 cluster on {pve}.
 131
 132 .File `/etc/apt/sources.list.d/ceph.list`
 133 ----
 134 deb http://download.proxmox.com/debian/ceph-quincy bullseye main
 135 ----
 136
 137
 138 Ceph Quincy Test Repository
 139 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 140
 141 This Ceph repository contains the Ceph Quincy packages before they are moved
 142 to the main repository. It is used to test new Ceph releases on {pve}.
 143
 144 .File `/etc/apt/sources.list.d/ceph.list`
 145 ----
 146 deb http://download.proxmox.com/debian/ceph-quincy bullseye test
 147 ----
 148
 149 Ceph Pacific Repository
 150 ~~~~~~~~~~~~~~~~~~~~~~~
 151
 152 NOTE: Ceph Pacific (16.2) was declared stable with {pve} 7.0.
 153
 154 This repository holds the main {pve} Ceph Pacific packages. They are suitable
 155 for production. Use this repository if you run the Ceph client or a full Ceph
 156 cluster on {pve}.
 157
 158 .File `/etc/apt/sources.list.d/ceph.list`
 159 ----
 160 deb http://download.proxmox.com/debian/ceph-pacific bullseye main
 161 ----
 162
 163
 164 Ceph Pacific Test Repository
 165 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 166
 167 This Ceph repository contains the Ceph Pacific packages before they are moved
 168 to the main repository. It is used to test new Ceph releases on {pve}.
 169
 170 .File `/etc/apt/sources.list.d/ceph.list`
 171 ----
 172 deb http://download.proxmox.com/debian/ceph-pacific bullseye test
 173 ----
 174
 175 [[sysadmin_package_repositories_ceph_octopus]]
 176 Ceph Octopus Repository
 177 ~~~~~~~~~~~~~~~~~~~~~~~
 178
 179 NOTE: Ceph Octopus (15.2) was declared stable with {pve} 6.3. It will continue
 180 to get updates for the xref:faq-support-table[remaining life time of the 6.x release]
 181 and also for {pve} 7.x until Ceph Octopus upstream EOL (~ 2022-07).
 182
 183 This repository holds the main {pve} Ceph Octopus packages. They are suitable
 184 for production. Use this repository if you run the Ceph client or a full Ceph
 185 cluster on {pve}.
 186
 187 .File `/etc/apt/sources.list.d/ceph.list`
 188 ----
 189 deb http://download.proxmox.com/debian/ceph-octopus bullseye main
 190 ----
 191
 192 Note that on an older {pve} 6.x you need to change `bullseye` to `buster` in
 193 the repository specification above.
 194
 195
 196 Ceph Octopus Test Repository
 197 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 198
 199 This Ceph repository contains the Ceph packages before they are moved to the
 200 main repository. It is used to test new Ceph releases on {pve}.
 201
 202 .File `/etc/apt/sources.list.d/ceph.list`
 203 ----
 204 deb http://download.proxmox.com/debian/ceph-octopus bullseye test
 205 ----
 206
 207 [[repos_secure_apt]]
 208
 209 SecureApt
 210 ~~~~~~~~~
 211
 212 The 'Release' files in the repositories are signed with GnuPG. APT is using
 213 these signatures to verify that all packages are from a trusted source.
 214
 215 If you install {pve} from an official ISO image, the key for verification is
 216 already installed.
 217
 218 If you install {pve} on top of Debian, download and install
 219 the key with the following commands:
 220
 221 ----
 222  # wget https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 223 ----
 224
 225 Verify the checksum afterwards with the `sha512sum` CLI tool:
 226
 227 ----
 228 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 229 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 230 ----
 231
 232 or the `md5sum` CLI tool:
 233
 234 ----
 235 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 236 bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 237 ----
 238
 239
 240 ifdef::wiki[]
 241
 242 // include note about older releases, but only for wiki
 243
 244
 245 {pve} 6.x Repositories
 246 ~~~~~~~~~~~~~~~~~~~~~~
 247
 248 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
 249 out of date. Existing installations should be updated. Nevertheless access to
 250 these repositories is still provided.
 251
 252 [width="100%",cols="<d,3m",options="header"]
 253 |===========================================================
 254 |Repository                 | sources.list entry
 255 |{pve} 6.x Enterprise       |
 256 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
 257 |{pve} 6.x No-Subscription  |
 258 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
 259 |{pve} 6.x Test             |
 260 deb http://download.proxmox.com/debian/pve buster pvetest
 261 |===========================================================
 262
 263
 264 {pve} 5.x Repositories
 265 ~~~~~~~~~~~~~~~~~~~~~~
 266
 267 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
 268 out of date. Existing installations should be updated. Nevertheless access to
 269 these repositories is still provided.
 270
 271 [width="100%",cols="<d,3m",options="header"]
 272 |===========================================================
 273 |Repository                 | sources.list entry
 274 |{pve} 5.x Enterprise       |
 275 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
 276 |{pve} 5.x No-Subscription  |
 277 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
 278 |{pve} 5.x Test             |
 279 deb http://download.proxmox.com/debian/pve stretch pvetest
 280 |===========================================================
 281
 282
 283 {pve} 4.x Repositories
 284 ~~~~~~~~~~~~~~~~~~~~~~
 285
 286 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
 287 out of date. Existing installations should be updated. Nevertheless access to
 288 these repositories is still provided.
 289
 290 [width="100%",cols="<d,3m",options="header"]
 291 |===========================================================
 292 |Repository                 | sources.list entry
 293 |{pve} 4.x Enterprise       |
 294 deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise
 295 |{pve} 4.x No-Subscription  |
 296 deb http://download.proxmox.com/debian/pve jessie pve-no-subscription
 297 |{pve} 4.x Test             |
 298 deb http://download.proxmox.com/debian/pve jessie pvetest
 299 |===========================================================
 300
 301
 302 {pve} 3.x Repositories
 303 ~~~~~~~~~~~~~~~~~~~~~~
 304
 305 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
 306 out of date. Existing installations should be updated. Nevertheless access to
 307 these repositories is still provided.
 308
 309 [width="100%",cols="<d,3m",options="header"]
 310 |===========================================================
 311 |Repository                 | sources.list entry
 312 |{pve} 3.x Enterprise       |
 313 deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise
 314 |{pve} 3.x No-Subscription  |
 315 deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription
 316 |{pve} 3.x Test             |
 317 deb http://download.proxmox.com/debian/pve wheezy pvetest
 318 |===========================================================
 319
 320
 321 Outdated: `stable` Repository `pve`
 322 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 323
 324 This repository is a leftover to ease the update to 3.1. It will not get any
 325 updates after the release of 3.1. Therefore the repository needs to be removed
 326 after the upgrade to 3.1.
 327
 328 .File `/etc/apt/sources.list`
 329 ----
 330 deb http://ftp.debian.org/debian wheezy main contrib
 331
 332 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
 333 # deb http://download.proxmox.com/debian wheezy pve
 334
 335 # security updates
 336 deb http://security.debian.org/ wheezy/updates main contrib
 337 ----
 338
 339
 340 Outdated: {pve} 2.x Repositories
 341 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 342
 343 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
 344 the latest version as soon as possible. In order to use the stable `pve` 2.x
 345 repository, check your sources.list:
 346
 347 .File `/etc/apt/sources.list`
 348 ----
 349 deb http://ftp.debian.org/debian squeeze main contrib
 350
 351 # PVE packages provided by proxmox.com
 352 deb http://download.proxmox.com/debian squeeze pve
 353
 354 # security updates
 355 deb http://security.debian.org/ squeeze/updates main contrib
 356 ----
 357
 358
 359 Outdated: {pve} VE 1.x Repositories
 360 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 361
 362 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
 363 to latest version as soon as possible.
 364
 365
 366 endif::wiki[]
 367 ifdef::manvolnum[]
 368 include::pve-copyright.adoc[]
 369 endif::manvolnum[]