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, 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://deb.debian.org/debian bookworm main contrib
  48 deb http://deb.debian.org/debian bookworm-updates main contrib
  49
  50 # security updates
  51 deb http://security.debian.org/debian-security bookworm-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 bookworm 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-virtual-environment/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 your host does
  78 not have a subscription key. Please configure the `pve-no-subscription`
  79 repository in 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 bookworm main contrib
  94 deb http://ftp.debian.org/debian bookworm-updates main contrib
  95
  96 # Proxmox VE pve-no-subscription repository provided by proxmox.com,
  97 # NOT recommended for production use
  98 deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
  99
 100 # security updates
 101 deb http://security.debian.org/debian-security bookworm-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 bookworm 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 Reef Enterprise Repository
 123 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 124
 125 This repository holds the enterprise {pve} Ceph 18.2 Reef packages. They are
 126 suitable for production. Use this repository if you run the Ceph client or a
 127 full Ceph cluster on {pve}.
 128
 129 .File `/etc/apt/sources.list.d/ceph.list`
 130 ----
 131 deb https://enterprise.proxmox.com/debian/ceph-reef bookworm enterprise
 132 ----
 133
 134
 135 Ceph Reef No-Subscription Repository
 136 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 137
 138 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
 139 to the enterprise repository and after they where on the test repository.
 140
 141 NOTE: It's recommended to use the enterprise repository for production
 142 machines.
 143
 144 .File `/etc/apt/sources.list.d/ceph.list`
 145 ----
 146 deb http://download.proxmox.com/debian/ceph-reef bookworm no-subscription
 147 ----
 148
 149
 150 Ceph Reef Test Repository
 151 ~~~~~~~~~~~~~~~~~~~~~~~~~
 152
 153 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
 154 to the main repository. It is used to test new Ceph releases on {pve}.
 155
 156 .File `/etc/apt/sources.list.d/ceph.list`
 157 ----
 158 deb http://download.proxmox.com/debian/ceph-reef bookworm test
 159 ----
 160
 161 Ceph Quincy Enterprise Repository
 162 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 163
 164 This repository holds the enterprise {pve} Ceph Quincy packages. They are
 165 suitable for production. Use this repository if you run the Ceph client or a
 166 full Ceph cluster on {pve}.
 167
 168 .File `/etc/apt/sources.list.d/ceph.list`
 169 ----
 170 deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise
 171 ----
 172
 173
 174 Ceph Quincy No-Subscription Repository
 175 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 176
 177 This Ceph repository contains the Ceph Quincy packages before they are moved
 178 to the enterprise repository and after they where on the test repository.
 179
 180 NOTE: It's recommended to use the enterprise repository for production
 181 machines.
 182
 183 .File `/etc/apt/sources.list.d/ceph.list`
 184 ----
 185 deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription
 186 ----
 187
 188
 189 Ceph Quincy Test Repository
 190 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 191
 192 This Ceph repository contains the Ceph Quincy packages before they are moved
 193 to the main repository. It is used to test new Ceph releases on {pve}.
 194
 195 .File `/etc/apt/sources.list.d/ceph.list`
 196 ----
 197 deb http://download.proxmox.com/debian/ceph-quincy bookworm test
 198 ----
 199
 200 Older Ceph Repositories
 201 ~~~~~~~~~~~~~~~~~~~~~~~
 202
 203 {pve} 8 doesn't support Ceph Pacific, Ceph Octopus, or even older releases for
 204 hyper-converged setups. For those releases, you need to first upgrade Ceph to a
 205 newer release before upgrading to Proxmox VE 8.
 206
 207 See the respective
 208 https://pve.proxmox.com/wiki/Category:Ceph_Upgrade[upgrade guide] for details.
 209
 210
 211 [[sysadmin_debian_firmware_repo]]
 212 Debian Firmware Repository
 213 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 214
 215 Starting with Debian Bookworm ({pve} 8) non-free firmware (as defined by
 216 https://www.debian.org/social_contract#guidelines[DFSG]) has been moved to the
 217 newly created Debian repository component `non-free-firmware`.
 218
 219 Enable this repository if you want to set up
 220 xref:sysadmin_firmware_cpu[Early OS Microcode Updates] or need additional
 221 xref:sysadmin_firmware_runtime_files[Runtime Firmware Files] not already
 222 included in the pre-installed package `pve-firmware`.
 223
 224 To be able to install packages from this component, run
 225 `editor /etc/apt/sources.list`, append `non-free-firmware` to the end of each
 226 `.debian.org` repository line and run `apt update`.
 227
 228
 229 [[repos_secure_apt]]
 230
 231 SecureApt
 232 ~~~~~~~~~
 233
 234 The 'Release' files in the repositories are signed with GnuPG. APT is using
 235 these signatures to verify that all packages are from a trusted source.
 236
 237 If you install {pve} from an official ISO image, the key for verification is
 238 already installed.
 239
 240 If you install {pve} on top of Debian, download and install
 241 the key with the following commands:
 242
 243 ----
 244  # wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 245 ----
 246
 247 Verify the checksum afterwards with the `sha512sum` CLI tool:
 248
 249 ----
 250 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 251 7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87 /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 252 ----
 253
 254 or the `md5sum` CLI tool:
 255
 256 ----
 257 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 258 41558dc019ef90bd0f6067644a51cf5b /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 259 ----
 260
 261
 262 ifdef::wiki[]
 263
 264 // include note about older releases, but only for wiki
 265
 266 {pve} 7.x Repositories
 267 ~~~~~~~~~~~~~~~~~~~~~~
 268
 269 {pve} 7.x is based on Debian 11.x (``bullseye''). Please note that this release
 270 is out of date (see the xref:faq-support-table[FAQ support table]). Existing
 271 installations should be updated. Nevertheless access to these repositories is
 272 still provided.
 273
 274 [width="100%",cols="<d,3m",options="header"]
 275 |===========================================================
 276 |Repository                 | sources.list entry
 277 |{pve} 7.x Enterprise       |
 278 deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise
 279 |{pve} 7.x No-Subscription  |
 280 deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
 281 |{pve} 7.x Test             |
 282 deb http://download.proxmox.com/debian/pve bullseye pvetest
 283 |===========================================================
 284
 285 Release key URL: https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg
 286
 287 Release key hash sums:
 288
 289 ----
 290 sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 291 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa
 292
 293 md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 294 bcc35c7173e0845c0d6ad6470b70f50e
 295 ----
 296
 297
 298 {pve} 6.x Repositories
 299 ~~~~~~~~~~~~~~~~~~~~~~
 300
 301 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
 302 out of date. Existing installations should be updated. Nevertheless access to
 303 these repositories is still provided.
 304
 305 [width="100%",cols="<d,3m",options="header"]
 306 |===========================================================
 307 |Repository                 | sources.list entry
 308 |{pve} 6.x Enterprise       |
 309 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
 310 |{pve} 6.x No-Subscription  |
 311 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
 312 |{pve} 6.x Test             |
 313 deb http://download.proxmox.com/debian/pve buster pvetest
 314 |===========================================================
 315
 316
 317 {pve} 5.x Repositories
 318 ~~~~~~~~~~~~~~~~~~~~~~
 319
 320 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
 321 out of date. Existing installations should be updated. Nevertheless access to
 322 these repositories is still provided.
 323
 324 [width="100%",cols="<d,3m",options="header"]
 325 |===========================================================
 326 |Repository                 | sources.list entry
 327 |{pve} 5.x Enterprise       |
 328 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
 329 |{pve} 5.x No-Subscription  |
 330 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
 331 |{pve} 5.x Test             |
 332 deb http://download.proxmox.com/debian/pve stretch pvetest
 333 |===========================================================
 334
 335
 336 {pve} 4.x Repositories
 337 ~~~~~~~~~~~~~~~~~~~~~~
 338
 339 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
 340 out of date. Existing installations should be updated. Nevertheless access to
 341 these repositories is still provided.
 342
 343 [width="100%",cols="<d,3m",options="header"]
 344 |===========================================================
 345 |Repository                 | sources.list entry
 346 |{pve} 4.x Enterprise       |
 347 deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise
 348 |{pve} 4.x No-Subscription  |
 349 deb http://download.proxmox.com/debian/pve jessie pve-no-subscription
 350 |{pve} 4.x Test             |
 351 deb http://download.proxmox.com/debian/pve jessie pvetest
 352 |===========================================================
 353
 354
 355 {pve} 3.x Repositories
 356 ~~~~~~~~~~~~~~~~~~~~~~
 357
 358 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
 359 out of date. Existing installations should be updated. Nevertheless access to
 360 these repositories is still provided.
 361
 362 [width="100%",cols="<d,3m",options="header"]
 363 |===========================================================
 364 |Repository                 | sources.list entry
 365 |{pve} 3.x Enterprise       |
 366 deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise
 367 |{pve} 3.x No-Subscription  |
 368 deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription
 369 |{pve} 3.x Test             |
 370 deb http://download.proxmox.com/debian/pve wheezy pvetest
 371 |===========================================================
 372
 373
 374 Outdated: `stable` Repository `pve`
 375 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 376
 377 This repository is a leftover to ease the update to 3.1. It will not get any
 378 updates after the release of 3.1. Therefore the repository needs to be removed
 379 after the upgrade to 3.1.
 380
 381 .File `/etc/apt/sources.list`
 382 ----
 383 deb http://ftp.debian.org/debian wheezy main contrib
 384
 385 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
 386 # deb http://download.proxmox.com/debian wheezy pve
 387
 388 # security updates
 389 deb http://security.debian.org/ wheezy/updates main contrib
 390 ----
 391
 392
 393 Outdated: {pve} 2.x Repositories
 394 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 395
 396 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
 397 the latest version as soon as possible. In order to use the stable `pve` 2.x
 398 repository, check your sources.list:
 399
 400 .File `/etc/apt/sources.list`
 401 ----
 402 deb http://ftp.debian.org/debian squeeze main contrib
 403
 404 # PVE packages provided by proxmox.com
 405 deb http://download.proxmox.com/debian squeeze pve
 406
 407 # security updates
 408 deb http://security.debian.org/ squeeze/updates main contrib
 409 ----
 410
 411
 412 Outdated: {pve} VE 1.x Repositories
 413 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 414
 415 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
 416 to latest version as soon as possible.
 417
 418
 419 endif::wiki[]
 420 ifdef::manvolnum[]
 421 include::pve-copyright.adoc[]
 422 endif::manvolnum[]