From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 0B5DC7619E for ; Wed, 14 Jul 2021 19:34:05 +0200 (CEST) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id EF07215662 for ; Wed, 14 Jul 2021 19:34:04 +0200 (CEST) Received: from proxmox-new.maurer-it.com (proxmox-new.maurer-it.com [94.136.29.106]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by firstgate.proxmox.com (Proxmox) with ESMTPS id 2BB9B15651 for ; Wed, 14 Jul 2021 19:34:03 +0200 (CEST) Received: from proxmox-new.maurer-it.com (localhost.localdomain [127.0.0.1]) by proxmox-new.maurer-it.com (Proxmox) with ESMTP id C0A7B41440 for ; Wed, 14 Jul 2021 19:34:02 +0200 (CEST) Date: Wed, 14 Jul 2021 19:34:01 +0200 From: Stoiko Ivanov To: Fabian Ebner Cc: pmg-devel@lists.proxmox.com Message-ID: <20210714193401.309c18d8@rosa.proxmox.com> In-Reply-To: <20210714113245.67543-1-f.ebner@proxmox.com> References: <20210714113245.67543-1-f.ebner@proxmox.com> X-Mailer: Claws Mail 3.17.8 (GTK+ 2.24.33; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.443 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pmg-devel] applied: [PATCH pmg-docs] package repositories: mention new apt repository ui X-BeenThere: pmg-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox Mail Gateway development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 Jul 2021 17:34:05 -0000 huge thanks for the patch - applied with... On Wed, 14 Jul 2021 13:32:45 +0200 Fabian Ebner wrote: > Adapted from PVE, including the Sources.list section, as it uses > shorter sentences/is more readable. > > Signed-off-by: Fabian Ebner > --- > .../screenshot/pmg-gui-admin-repositories.png | Bin 0 -> 147482 bytes > pmg-installation.adoc | 50 +++++++++++++----- > 2 files changed, 37 insertions(+), 13 deletions(-) > create mode 100644 images/screenshot/pmg-gui-admin-repositories.png > > diff --git a/images/screenshot/pmg-gui-admin-repositories.png b/images/screenshot/pmg-gui-admin-repositories.png > new file mode 100644 > index 0000000000000000000000000000000000000000..b3952f879abb92676740d964f01d80afe9df6553 > GIT binary patch > literal 147482 > ..snip.. > > diff --git a/pmg-installation.adoc b/pmg-installation.adoc > index 219dc11..a7b8ccf 100644 > --- a/pmg-installation.adoc > +++ b/pmg-installation.adoc > @@ -281,18 +281,42 @@ apt install proxmox-mailgateway-container > Package Repositories > -------------------- > > -All {debian} based systems use > -https://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as a package > -management tool. The list of repositories is defined in > -`/etc/apt/sources.list` and `.list` files found inside > -`/etc/apt/sources.d/`. Updates can be installed directly using > -`apt`, or via the GUI. > - > -Apt `sources.list` files list one package repository per line, with > -the most preferred source listed first. Empty lines are ignored, and a > -`#` character anywhere on a line marks the remainder of that line as a > -comment. The information available from the configured sources is > -acquired by `apt update`. > +{pmg} uses http://en.wikipedia.org/wiki/Advanced_Packaging_Tool[APT] as its > +package management tool like any other Debian-based system. > + > +Repositories in {pmg} > +~~~~~~~~~~~~~~~~~~~~~ > + > +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="pmg-gui-admin-repositories.png"] > + > +Since {pmg} 7.0 you can check the repository state in the web interface. The > +'Dasboard' shows a high level status overview, while the separate 'Repository' s/Dasboard/Dashboard/ fixed up > +panel (accessible via 'Administration') 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 update`. Updates can be installed > +directly using `apt`, or via the GUI (Administration -> Updates). > > .File `/etc/apt/sources.list` > ---- > @@ -306,7 +330,7 @@ deb http://security.debian.org/debian-security bullseye-security main contrib > # Proxmox Mail Gateway repo required too - see below! > ---- > > -In addition, {pmg} provides three different package repositories. > +{pmg} provides three different package repositories. > > > {pmg} Enterprise Repository