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 {pve} automatically checks for package updates on a daily basis. The `root@pam`
  12 user is notified via email about available updates. From the GUI, the
  13 'Changelog' button can be used to see more details about an selected update.
  14
  15 Repositories in {pve}
  16 ~~~~~~~~~~~~~~~~~~~~~
  17
  18 Repositories are a collection of software packages, they can be used to install
  19 new software, but are also important to get new updates.
  20
  21 NOTE: You need valid Debian and Proxmox repositories to get the latest
  22 security updates, bug fixes and new features.
  23
  24 APT Repositories are defined in the file `/etc/apt/sources.list` and in `.list`
  25 files placed in `/etc/apt/sources.list.d/`.
  26
  27 Repository Management
  28 ^^^^^^^^^^^^^^^^^^^^^
  29
  30 [thumbnail="screenshot/gui-node-repositories.png"]
  31
  32 Since Proxmox VE 7, you can check the repository state in the web interface.
  33 The node summary panel shows a high level status overview, while the separate
  34 'Repository' panel shows in-depth status and list of all configured
  35 repositories.
  36
  37 Basic repository management, for example, activating or deactivating a
  38 repository, is also supported.
  39
  40 Sources.list
  41 ^^^^^^^^^^^^
  42
  43 In a `sources.list` file, each line defines a package repository. The preferred
  44 source must come first.  Empty lines are ignored. A `#` character anywhere on a
  45 line marks the remainder of that line as a comment. The available packages from
  46 a repository are acquired by running `apt-get update`. Updates can be installed
  47 directly using `apt-get`, or via the GUI (Node -> Updates).
  48
  49 .File `/etc/apt/sources.list`
  50 ----
  51 deb http://deb.debian.org/debian bookworm main contrib
  52 deb http://deb.debian.org/debian bookworm-updates main contrib
  53
  54 # security updates
  55 deb http://security.debian.org/debian-security bookworm-security main contrib
  56 ----
  57
  58 {pve} provides three different package repositories.
  59
  60 [[sysadmin_enterprise_repo]]
  61 {pve} Enterprise Repository
  62 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  63
  64 This is the recommended repository and available for all {pve} subscription
  65 users. It contains the most stable packages and is suitable for production use.
  66 The `pve-enterprise` repository is enabled by default:
  67
  68 .File `/etc/apt/sources.list.d/pve-enterprise.list`
  69 ----
  70 deb https://enterprise.proxmox.com/debian/pve bookworm pve-enterprise
  71 ----
  72
  73 Please note that you need a valid subscription key to access the
  74 `pve-enterprise` repository. We offer different support levels, which you can
  75 find further details about at {pricing-url}.
  76
  77 NOTE: You can disable this repository by commenting out the above line using a
  78 `#` (at the start of the line). This prevents error messages if your host does
  79 not have a subscription key. Please configure the `pve-no-subscription`
  80 repository in that case.
  81
  82 [[sysadmin_no_subscription_repo]]
  83 {pve} No-Subscription Repository
  84 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  85
  86 As the name suggests, you do not need a subscription key to access
  87 this repository. It can be used for testing and non-production
  88 use. It's not recommended to use this on production servers, as these
  89 packages are not always as heavily tested and validated.
  90
  91 We recommend to configure this repository in `/etc/apt/sources.list`.
  92
  93 .File `/etc/apt/sources.list`
  94 ----
  95 deb http://ftp.debian.org/debian bookworm main contrib
  96 deb http://ftp.debian.org/debian bookworm-updates main contrib
  97
  98 # Proxmox VE pve-no-subscription repository provided by proxmox.com,
  99 # NOT recommended for production use
 100 deb http://download.proxmox.com/debian/pve bookworm pve-no-subscription
 101
 102 # security updates
 103 deb http://security.debian.org/debian-security bookworm-security main contrib
 104 ----
 105
 106
 107 [[sysadmin_test_repo]]
 108 {pve} Test Repository
 109 ~~~~~~~~~~~~~~~~~~~~~~
 110
 111 This repository contains the latest packages and is primarily used by developers
 112 to test new features. To configure it, add the following line to
 113 `/etc/apt/sources.list`:
 114
 115 .sources.list entry for `pvetest`
 116 ----
 117 deb http://download.proxmox.com/debian/pve bookworm pvetest
 118 ----
 119
 120 WARNING: The `pvetest` repository should (as the name implies) only be used for
 121 testing new features or bug fixes.
 122
 123 [[sysadmin_package_repositories_ceph]]
 124 Ceph Reef Enterprise Repository
 125 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 126
 127 This repository holds the enterprise {pve} Ceph 18.2 Reef packages. They are
 128 suitable for production. Use this repository if you run the Ceph client or a
 129 full Ceph cluster on {pve}.
 130
 131 .File `/etc/apt/sources.list.d/ceph.list`
 132 ----
 133 deb https://enterprise.proxmox.com/debian/ceph-reef bookworm enterprise
 134 ----
 135
 136
 137 Ceph Reef No-Subscription Repository
 138 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 139
 140 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
 141 to the enterprise repository and after they where on the test repository.
 142
 143 NOTE: It's recommended to use the enterprise repository for production
 144 machines.
 145
 146 .File `/etc/apt/sources.list.d/ceph.list`
 147 ----
 148 deb http://download.proxmox.com/debian/ceph-reef bookworm no-subscription
 149 ----
 150
 151
 152 Ceph Reef Test Repository
 153 ~~~~~~~~~~~~~~~~~~~~~~~~~
 154
 155 This Ceph repository contains the Ceph 18.2 Reef packages before they are moved
 156 to the main repository. It is used to test new Ceph releases on {pve}.
 157
 158 .File `/etc/apt/sources.list.d/ceph.list`
 159 ----
 160 deb http://download.proxmox.com/debian/ceph-reef bookworm test
 161 ----
 162
 163 Ceph Quincy Enterprise Repository
 164 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 165
 166 This repository holds the enterprise {pve} Ceph Quincy packages. They are
 167 suitable for production. Use this repository if you run the Ceph client or a
 168 full Ceph cluster on {pve}.
 169
 170 .File `/etc/apt/sources.list.d/ceph.list`
 171 ----
 172 deb https://enterprise.proxmox.com/debian/ceph-quincy bookworm enterprise
 173 ----
 174
 175
 176 Ceph Quincy No-Subscription Repository
 177 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 178
 179 This Ceph repository contains the Ceph Quincy packages before they are moved
 180 to the enterprise repository and after they where on the test repository.
 181
 182 NOTE: It's recommended to use the enterprise repository for production
 183 machines.
 184
 185 .File `/etc/apt/sources.list.d/ceph.list`
 186 ----
 187 deb http://download.proxmox.com/debian/ceph-quincy bookworm no-subscription
 188 ----
 189
 190
 191 Ceph Quincy Test Repository
 192 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
 193
 194 This Ceph repository contains the Ceph Quincy packages before they are moved
 195 to the main repository. It is used to test new Ceph releases on {pve}.
 196
 197 .File `/etc/apt/sources.list.d/ceph.list`
 198 ----
 199 deb http://download.proxmox.com/debian/ceph-quincy bookworm test
 200 ----
 201
 202 Older Ceph Repositories
 203 ~~~~~~~~~~~~~~~~~~~~~~~
 204
 205 {pve} 8 doesn't support Ceph Pacific, Ceph Octopus, or even older releases for
 206 hyper-converged setups. For those releases, you need to first upgrade Ceph to a
 207 newer release before upgrading to Proxmox VE 8.
 208
 209 See the respective
 210 https://pve.proxmox.com/wiki/Category:Ceph_Upgrade[upgrade guide] for details.
 211
 212
 213 [[sysadmin_debian_firmware_repo]]
 214 Debian Firmware Repository
 215 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 216
 217 Starting with Debian Bookworm ({pve} 8) non-free firmware (as defined by
 218 https://www.debian.org/social_contract#guidelines[DFSG]) has been moved to the
 219 newly created Debian repository component `non-free-firmware`.
 220
 221 Enable this repository if you want to set up
 222 xref:sysadmin_firmware_cpu[Early OS Microcode Updates] or need additional
 223 xref:sysadmin_firmware_runtime_files[Runtime Firmware Files] not already
 224 included in the pre-installed package `pve-firmware`.
 225
 226 To be able to install packages from this component, run
 227 `editor /etc/apt/sources.list`, append `non-free-firmware` to the end of each
 228 `.debian.org` repository line and run `apt update`.
 229
 230
 231 [[repos_secure_apt]]
 232
 233 SecureApt
 234 ~~~~~~~~~
 235
 236 The 'Release' files in the repositories are signed with GnuPG. APT is using
 237 these signatures to verify that all packages are from a trusted source.
 238
 239 If you install {pve} from an official ISO image, the key for verification is
 240 already installed.
 241
 242 If you install {pve} on top of Debian, download and install
 243 the key with the following commands:
 244
 245 ----
 246  # wget https://enterprise.proxmox.com/debian/proxmox-release-bookworm.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 247 ----
 248
 249 Verify the checksum afterwards with the `sha512sum` CLI tool:
 250
 251 ----
 252 # sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 253 7da6fe34168adc6e479327ba517796d4702fa2f8b4f0a9833f5ea6e6b48f6507a6da403a274fe201595edc86a84463d50383d07f64bdde2e3658108db7d6dc87 /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 254 ----
 255
 256 or the `md5sum` CLI tool:
 257
 258 ----
 259 # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 260 41558dc019ef90bd0f6067644a51cf5b /etc/apt/trusted.gpg.d/proxmox-release-bookworm.gpg
 261 ----
 262
 263
 264 ifdef::wiki[]
 265
 266 // include note about older releases, but only for wiki
 267
 268 {pve} 7.x Repositories
 269 ~~~~~~~~~~~~~~~~~~~~~~
 270
 271 {pve} 7.x is based on Debian 11.x (``bullseye''). Please note that this release
 272 is out of date (see the xref:faq-support-table[FAQ support table]). Existing
 273 installations should be updated. Nevertheless access to these repositories is
 274 still provided.
 275
 276 [width="100%",cols="<d,3m",options="header"]
 277 |===========================================================
 278 |Repository                 | sources.list entry
 279 |{pve} 7.x Enterprise       |
 280 deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise
 281 |{pve} 7.x No-Subscription  |
 282 deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription
 283 |{pve} 7.x Test             |
 284 deb http://download.proxmox.com/debian/pve bullseye pvetest
 285 |===========================================================
 286
 287 Release key URL: https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg
 288
 289 Release key hash sums:
 290
 291 ----
 292 sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 293 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa
 294
 295 md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg
 296 bcc35c7173e0845c0d6ad6470b70f50e
 297 ----
 298
 299
 300 {pve} 6.x Repositories
 301 ~~~~~~~~~~~~~~~~~~~~~~
 302
 303 {pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is
 304 out of date. Existing installations should be updated. Nevertheless access to
 305 these repositories is still provided.
 306
 307 [width="100%",cols="<d,3m",options="header"]
 308 |===========================================================
 309 |Repository                 | sources.list entry
 310 |{pve} 6.x Enterprise       |
 311 deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise
 312 |{pve} 6.x No-Subscription  |
 313 deb http://download.proxmox.com/debian/pve buster pve-no-subscription
 314 |{pve} 6.x Test             |
 315 deb http://download.proxmox.com/debian/pve buster pvetest
 316 |===========================================================
 317
 318
 319 {pve} 5.x Repositories
 320 ~~~~~~~~~~~~~~~~~~~~~~
 321
 322 {pve} 5.x is based on Debian 9.x (``stretch''). Please note that this release is
 323 out of date. Existing installations should be updated. Nevertheless access to
 324 these repositories is still provided.
 325
 326 [width="100%",cols="<d,3m",options="header"]
 327 |===========================================================
 328 |Repository                 | sources.list entry
 329 |{pve} 5.x Enterprise       |
 330 deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise
 331 |{pve} 5.x No-Subscription  |
 332 deb http://download.proxmox.com/debian/pve stretch pve-no-subscription
 333 |{pve} 5.x Test             |
 334 deb http://download.proxmox.com/debian/pve stretch pvetest
 335 |===========================================================
 336
 337
 338 {pve} 4.x Repositories
 339 ~~~~~~~~~~~~~~~~~~~~~~
 340
 341 {pve} 4.x is based on Debian 8.x (``jessie''). Please note that this release is
 342 out of date. Existing installations should be updated. Nevertheless access to
 343 these repositories is still provided.
 344
 345 [width="100%",cols="<d,3m",options="header"]
 346 |===========================================================
 347 |Repository                 | sources.list entry
 348 |{pve} 4.x Enterprise       |
 349 deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise
 350 |{pve} 4.x No-Subscription  |
 351 deb http://download.proxmox.com/debian/pve jessie pve-no-subscription
 352 |{pve} 4.x Test             |
 353 deb http://download.proxmox.com/debian/pve jessie pvetest
 354 |===========================================================
 355
 356
 357 {pve} 3.x Repositories
 358 ~~~~~~~~~~~~~~~~~~~~~~
 359
 360 {pve} 3.x is based on Debian 7.x (``wheezy''). Please note that this release is
 361 out of date. Existing installations should be updated. Nevertheless access to
 362 these repositories is still provided.
 363
 364 [width="100%",cols="<d,3m",options="header"]
 365 |===========================================================
 366 |Repository                 | sources.list entry
 367 |{pve} 3.x Enterprise       |
 368 deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise
 369 |{pve} 3.x No-Subscription  |
 370 deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription
 371 |{pve} 3.x Test             |
 372 deb http://download.proxmox.com/debian/pve wheezy pvetest
 373 |===========================================================
 374
 375
 376 Outdated: `stable` Repository `pve`
 377 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 378
 379 This repository is a leftover to ease the update to 3.1. It will not get any
 380 updates after the release of 3.1. Therefore the repository needs to be removed
 381 after the upgrade to 3.1.
 382
 383 .File `/etc/apt/sources.list`
 384 ----
 385 deb http://ftp.debian.org/debian wheezy main contrib
 386
 387 # PVE packages provided by proxmox.com - NO UPDATES after the initial release of 3.1
 388 # deb http://download.proxmox.com/debian wheezy pve
 389
 390 # security updates
 391 deb http://security.debian.org/ wheezy/updates main contrib
 392 ----
 393
 394
 395 Outdated: {pve} 2.x Repositories
 396 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 397
 398 {pve} 2.x is based on Debian 6.0 (``squeeze'') and outdated. Please upgrade to
 399 the latest version as soon as possible. In order to use the stable `pve` 2.x
 400 repository, check your sources.list:
 401
 402 .File `/etc/apt/sources.list`
 403 ----
 404 deb http://ftp.debian.org/debian squeeze main contrib
 405
 406 # PVE packages provided by proxmox.com
 407 deb http://download.proxmox.com/debian squeeze pve
 408
 409 # security updates
 410 deb http://security.debian.org/ squeeze/updates main contrib
 411 ----
 412
 413
 414 Outdated: {pve} VE 1.x Repositories
 415 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 416
 417 {pve} 1.x is based on Debian 5.0 (``lenny'') and very outdated. Please upgrade
 418 to latest version as soon as possible.
 419
 420
 421 endif::wiki[]
 422 ifdef::manvolnum[]
 423 include::pve-copyright.adoc[]
 424 endif::manvolnum[]