X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=pve-package-repos.adoc;h=84141b4defd90438c3810f953ae2cd829c1d561f;hb=3b5307ff0a7b95e0fade7acd13754ebd08600ea0;hp=3358232fc93bcdc61b3c547ce9b261ef4b75226d;hpb=8e2aabac582c9fff17d166e66cf0a85f7ea8b3ed;p=pve-docs.git diff --git a/pve-package-repos.adoc b/pve-package-repos.adoc index 3358232..84141b4 100644 --- a/pve-package-repos.adoc +++ b/pve-package-repos.adoc @@ -6,40 +6,64 @@ ifdef::wiki[] endif::wiki[] {pve} uses http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as its -package management tool like any other Debian-based system. Repositories are -defined in the file `/etc/apt/sources.list` and in `.list` files placed in -`/etc/apt/sources.list.d/`. +package management tool like any other Debian-based system. -Each line defines a package repository. The preferred source must come first. -Empty lines are ignored. A `#` character anywhere on a line marks the remainder -of that line as a comment. The available packages from a repository are acquired -by running `apt-get update`. Updates can be installed directly using `apt-get`, -or via the GUI. +Repositories in {pve} +~~~~~~~~~~~~~~~~~~~~~ + +Repositories are a collection of software packages, they can be used to install +new software, but are also important to get new updates. + +NOTE: You need valid Debian and Proxmox repositories to get the latest +security updates, bug fixes and new features. + +APT Repositories are defined in the file `/etc/apt/sources.list` and in `.list` +files placed in `/etc/apt/sources.list.d/`. + +Repository Management +^^^^^^^^^^^^^^^^^^^^^ + +[thumbnail="screenshot/gui-node-repositories.png"] + +Since Proxmox VE 7.0 you can check the repository state in the web interface. +The node summary panel shows a high level status overview, while the separate +'Repository' panel shows in-depth status and list of all configured +repositories. + +Basic repository management, for example, activating or deactivating a +repository, is also supported. + +Sources.list +^^^^^^^^^^^^ + +In a `sources.list` file, each line defines a package repository. The preferred +source must come first. Empty lines are ignored. A `#` character anywhere on a +line marks the remainder of that line as a comment. The available packages from +a repository are acquired by running `apt-get update`. Updates can be installed +directly using `apt-get`, or via the GUI (Node -> Updates). .File `/etc/apt/sources.list` ---- -deb http://ftp.debian.org/debian buster main contrib -deb http://ftp.debian.org/debian buster-updates main contrib +deb http://ftp.debian.org/debian bullseye main contrib +deb http://ftp.debian.org/debian bullseye-updates main contrib # security updates -deb http://security.debian.org/debian-security buster/updates main contrib +deb http://security.debian.org/debian-security bullseye-security main contrib ---- -// FIXME for 7.0: change security update suite to bullseye-security -{pve} additionally provides three different package repositories. +{pve} provides three different package repositories. [[sysadmin_enterprise_repo]] {pve} Enterprise Repository ~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This is the default, stable and recommended repository, available for -all {pve} subscription users. It contains the most stable packages, -and is suitable for production use. The `pve-enterprise` repository is -enabled by default: +This is the default, stable, and recommended repository, available for all {pve} +subscription users. It contains the most stable packages and is suitable for +production use. The `pve-enterprise` repository is enabled by default: .File `/etc/apt/sources.list.d/pve-enterprise.list` ---- -deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise +deb https://enterprise.proxmox.com/debian/pve bullseye pve-enterprise ---- The `root@pam` user is notified via email about available updates. Click the @@ -66,15 +90,15 @@ We recommend to configure this repository in `/etc/apt/sources.list`. .File `/etc/apt/sources.list` ---- -deb http://ftp.debian.org/debian buster main contrib -deb http://ftp.debian.org/debian buster-updates main contrib +deb http://ftp.debian.org/debian bullseye main contrib +deb http://ftp.debian.org/debian bullseye-updates main contrib # PVE pve-no-subscription repository provided by proxmox.com, # NOT recommended for production use -deb http://download.proxmox.com/debian/pve buster pve-no-subscription +deb http://download.proxmox.com/debian/pve bullseye pve-no-subscription # security updates -deb http://security.debian.org/debian-security buster/updates main contrib +deb http://security.debian.org/debian-security bullseye-security main contrib ---- @@ -88,52 +112,73 @@ to test new features. To configure it, add the following line to .sources.list entry for `pvetest` ---- -deb http://download.proxmox.com/debian/pve buster pvetest +deb http://download.proxmox.com/debian/pve bullseye pvetest ---- WARNING: The `pvetest` repository should (as the name implies) only be used for testing new features or bug fixes. [[sysadmin_package_repositories_ceph]] -{pve} Ceph Repository -~~~~~~~~~~~~~~~~~~~~~ +Ceph Pacific Repository +~~~~~~~~~~~~~~~~~~~~~~~ + +NOTE: Ceph Pacific (16.2) was declared stable with {pve} 7.0. -This repository holds the main {pve} Ceph packages. They are suitable for -production. Use this repository if you run the Ceph client or a full Ceph +This repository holds the main {pve} Ceph Pacific packages. They are suitable +for production. Use this repository if you run the Ceph client or a full Ceph cluster on {pve}. .File `/etc/apt/sources.list.d/ceph.list` ---- -deb http://download.proxmox.com/debian/ceph-nautilus buster main +deb http://download.proxmox.com/debian/ceph-pacific bullseye main ---- -{pve} Ceph Testing Repository -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Ceph Pacific Test Repository +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This Ceph repository contains the Ceph packages before they are moved to the -main repository. It is used to test new Ceph releases on {pve}. +This Ceph repository contains the Ceph Pacific packages before they are moved +to the main repository. It is used to test new Ceph releases on {pve}. + +.File `/etc/apt/sources.list.d/ceph.list` +---- +deb http://download.proxmox.com/debian/ceph-pacific bullseye test +---- + +[[sysadmin_package_repositories_ceph_octopus]] +Ceph Octopus Repository +~~~~~~~~~~~~~~~~~~~~~~~ + +NOTE: Ceph Octopus (15.2) was declared stable with {pve} 6.3 it will continue +to get updates for the xref:faq-support-table[remaining life time of the 6.x release] +and also for {pve} 7.x until Ceph Octopus upstream EOL (~ 2022-07). + +This repository holds the main {pve} Ceph Octopus packages. They are suitable +for production. Use this repository if you run the Ceph client or a full Ceph +cluster on {pve}. .File `/etc/apt/sources.list.d/ceph.list` ---- -deb http://download.proxmox.com/debian/ceph-nautilus buster test +deb http://download.proxmox.com/debian/ceph-octopus bullseye main ---- -{pve} Ceph Luminous Repository For Upgrade -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Note that on an older {pve} 6.x you need to change `bullseye` to `buster` in +the repository specification above. + -If Ceph is deployed this repository is needed for the upgrade from {pve} 5.x to -{pve} 6.0. It provides packages for the older Ceph Luminous release for {pve} -6.0. +Ceph Octopus Test Repository +~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The https://pve.proxmox.com/wiki/Upgrade_from_5.x_to_6.0[Upgrade 5.x to 6.0] -document explains how to use this repository in detail. +This Ceph repository contains the Ceph packages before they are moved to the +main repository. It is used to test new Ceph releases on {pve}. .File `/etc/apt/sources.list.d/ceph.list` ---- -deb http://download.proxmox.com/debian/ceph-luminous buster main +deb http://download.proxmox.com/debian/ceph-octopus bullseye test ---- +[[repos_secure_apt]] + SecureApt ~~~~~~~~~ @@ -147,36 +192,46 @@ If you install {pve} on top of Debian, download and install the key with the following commands: ---- - # wget http://download.proxmox.com/debian/proxmox-ve-release-6.x.gpg -O /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg + # wget https://enterprise.proxmox.com/debian/proxmox-release-bullseye.gpg -O /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg ---- -Verify the checksum afterwards with: +Verify the checksum afterwards with the `sha512sum` CLI tool: ---- -# sha512sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg +# sha512sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg +7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg ---- -The output should be: +or the `md5sum` CLI tool: ---- -acca6f416917e8e11490a08a1e2842d500b3a5d9f322c6319db0927b2901c3eae23cfb5cd5df6facf2b57399d3cfa52ad7769ebdd75d9b204549ca147da52626 /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg +# md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg +bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg ---- -or: ----- -# md5sum /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg ----- -The output should be: +ifdef::wiki[] ----- -f3f6c5a3a67baf38ad178e5ff1ee270c /etc/apt/trusted.gpg.d/proxmox-ve-release-6.x.gpg ----- +// include note about older releases, but only for wiki -ifdef::wiki[] +{pve} 6.x Repositories +~~~~~~~~~~~~~~~~~~~~~~ -// include note about older releases, but only for wiki +{pve} 6.x is based on Debian 10.x (``buster''). Please note that this release is +out of date. Existing installations should be updated. Nevertheless access to +these repositories is still provided. + +[width="100%",cols="