]> git.proxmox.com Git - pve-docs.git/blobdiff - pve-package-repos.adoc
backup: clarify that CLI means FS-level and highlight retention-note
[pve-docs.git] / pve-package-repos.adoc
index 20e881f08ad44c06eb543ec5821770479032deb9..84141b4defd90438c3810f953ae2cd829c1d561f 100644 (file)
@@ -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
@@ -96,7 +122,7 @@ testing new features or bug fixes.
 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
@@ -151,6 +177,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 +195,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 +226,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 +245,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 +264,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 +283,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
 |===========================================================