X-Git-Url: https://git.proxmox.com/?a=blobdiff_plain;f=pve-package-repos.adoc;h=52169a0e81f74794850691bb041804a720abebeb;hb=f8a257d96a22fbb894d16d75bf001b2be5831437;hp=20e881f08ad44c06eb543ec5821770479032deb9;hpb=792c2bcb1b3dad0da5bf938616a9167353a023e0;p=pve-docs.git diff --git a/pve-package-repos.adoc b/pve-package-repos.adoc index 20e881f..52169a0 100644 --- a/pve-package-repos.adoc +++ b/pve-package-repos.adoc @@ -6,15 +6,41 @@ 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` ---- @@ -25,7 +51,7 @@ deb http://ftp.debian.org/debian bullseye-updates main contrib deb http://security.debian.org/debian-security bullseye-security main contrib ---- -{pve} additionally provides three different package repositories. +{pve} provides three different package repositories. [[sysadmin_enterprise_repo]] {pve} Enterprise Repository @@ -82,7 +108,7 @@ deb http://security.debian.org/debian-security bullseye-security main contrib This repository contains the latest packages and is primarily used by developers to test new features. To configure it, add the following line to -`etc/apt/sources.list`: +`/etc/apt/sources.list`: .sources.list entry for `pvetest` ---- @@ -93,10 +119,37 @@ WARNING: The `pvetest` repository should (as the name implies) only be used for testing new features or bug fixes. [[sysadmin_package_repositories_ceph]] +Ceph Quincy Repository +~~~~~~~~~~~~~~~~~~~~~~ + +NOTE: Ceph Quincy (17.2) was declared stable with {pve} 7.3 or after using the +Ceph 17.2.1 version. + +This repository holds the main {pve} Ceph Quincy 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-quincy bullseye main +---- + + +Ceph Quincy Test Repository +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +This Ceph repository contains the Ceph Quincy 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-quincy bullseye test +---- + Ceph Pacific Repository ~~~~~~~~~~~~~~~~~~~~~~~ -NOTE: Ceph Octopus (16.2) was declared stable with {pve} 7.0 +NOTE: Ceph Pacific (16.2) was declared stable with {pve} 7.0. 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 @@ -123,7 +176,7 @@ deb http://download.proxmox.com/debian/ceph-pacific bullseye test Ceph Octopus Repository ~~~~~~~~~~~~~~~~~~~~~~~ -NOTE: Ceph Octopus (15.2) was declared stable with {pve} 6.3 it will continue +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). @@ -151,6 +204,8 @@ main repository. It is used to test new Ceph releases on {pve}. deb http://download.proxmox.com/debian/ceph-octopus bullseye test ---- +[[repos_secure_apt]] + SecureApt ~~~~~~~~~ @@ -167,26 +222,17 @@ the key with the following commands: # 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-release-bullseye.gpg ----- - -The output should be: - ----- 7fb03ec8a1675723d2853b84aa4fdb49a46a3bb72b9951361488bfd19b29aab0a789a4f8c7406e71a69aabbc727c936d3549731c4659ffa1a08f44db8fdcebfa /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg ---- -or: +or the `md5sum` CLI tool: ---- # md5sum /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg ----- -The output should be: - ----- bcc35c7173e0845c0d6ad6470b70f50e /etc/apt/trusted.gpg.d/proxmox-release-bullseye.gpg ---- @@ -207,11 +253,11 @@ these repositories is still provided. |=========================================================== |Repository | sources.list entry |{pve} 6.x Enterprise | -deb https://enterprise.proxmox.com/debian buster pve-enterprise +deb https://enterprise.proxmox.com/debian/pve buster pve-enterprise |{pve} 6.x No-Subscription | -deb http://download.proxmox.com/debian buster pve-no-subscription +deb http://download.proxmox.com/debian/pve buster pve-no-subscription |{pve} 6.x Test | -deb http://download.proxmox.com/debian buster pvetest +deb http://download.proxmox.com/debian/pve buster pvetest |=========================================================== @@ -226,11 +272,11 @@ these repositories is still provided. |=========================================================== |Repository | sources.list entry |{pve} 5.x Enterprise | -deb https://enterprise.proxmox.com/debian stretch pve-enterprise +deb https://enterprise.proxmox.com/debian/pve stretch pve-enterprise |{pve} 5.x No-Subscription | -deb http://download.proxmox.com/debian stretch pve-no-subscription +deb http://download.proxmox.com/debian/pve stretch pve-no-subscription |{pve} 5.x Test | -deb http://download.proxmox.com/debian stretch pvetest +deb http://download.proxmox.com/debian/pve stretch pvetest |=========================================================== @@ -245,11 +291,11 @@ these repositories is still provided. |=========================================================== |Repository | sources.list entry |{pve} 4.x Enterprise | -deb https://enterprise.proxmox.com/debian jessie pve-enterprise +deb https://enterprise.proxmox.com/debian/pve jessie pve-enterprise |{pve} 4.x No-Subscription | -deb http://download.proxmox.com/debian jessie pve-no-subscription +deb http://download.proxmox.com/debian/pve jessie pve-no-subscription |{pve} 4.x Test | -deb http://download.proxmox.com/debian jessie pvetest +deb http://download.proxmox.com/debian/pve jessie pvetest |=========================================================== @@ -264,11 +310,11 @@ these repositories is still provided. |=========================================================== |Repository | sources.list entry |{pve} 3.x Enterprise | -deb https://enterprise.proxmox.com/debian wheezy pve-enterprise +deb https://enterprise.proxmox.com/debian/pve wheezy pve-enterprise |{pve} 3.x No-Subscription | -deb http://download.proxmox.com/debian wheezy pve-no-subscription +deb http://download.proxmox.com/debian/pve wheezy pve-no-subscription |{pve} 3.x Test | -deb http://download.proxmox.com/debian wheezy pvetest +deb http://download.proxmox.com/debian/pve wheezy pvetest |===========================================================