From: Thomas Lamprecht <t.lamprecht@proxmox.com>
Date: Mon, 5 Jul 2021 13:46:44 +0000 (+0200)
Subject: repos: mention APT repo status gui
X-Git-Url: https://git.proxmox.com/?p=pve-docs.git;a=commitdiff_plain;h=d9beb571bd1795e3d257c46a9e6f3885d76a5482

repos: mention APT repo status gui

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
---

diff --git a/images/screenshot/gui-node-repositories.png b/images/screenshot/gui-node-repositories.png
new file mode 100644
index 0000000..6c61e87
Binary files /dev/null and b/images/screenshot/gui-node-repositories.png differ
diff --git a/pve-package-repos.adoc b/pve-package-repos.adoc
index 4d4051c..a3e94d5 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
@@ -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
 ~~~~~~~~~