Commit Graph

464 Commits

Author SHA1 Message Date
Thomas Lamprecht
6bd70b953a update static
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-02-13 18:08:22 +01:00
Thomas Lamprecht
622d092d4b api-viewer: port over search, expand/collapse all & deeplink from PVE
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-02-13 18:06:30 +01:00
Thomas Lamprecht
ab3ca2634d api-viewer: whitespace, indentation and typo fixes
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-02-13 17:53:57 +01:00
Thomas Lamprecht
509eaa9290 adapt toc2 and more responsive style changes from PVE
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-02-13 16:42:03 +01:00
Thomas Lamprecht
fd3c20c24b bump version to 6.1-3
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-10 11:28:33 +01:00
Thomas Lamprecht
f475c3fa8b gen-pmg.conf.5: allow to overwrite undocumented key error for bootstrapping
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-10 11:28:33 +01:00
Thomas Lamprecht
6e74616302 gen-pmg.conf.5-opts: drop unused Data::Dumper
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-09 13:40:18 +01:00
Thomas Lamprecht
2b6070e788 gen-pmg.conf.5-opts: whitespace cleanup
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2020-01-09 13:40:05 +01:00
Julian Zehnter
312595900a Feature #2438 add support for lmtp delivery to downstream servers
new feature lmtp support for simplifying setups with lmtp capable
downstream servers (e.g. dovecot) Postfix support lmtp out of the box
and can now deliver mails directly to internal mailbox servers
without one more smtp connection

extending the documentation for new lmtp option in
MailProxyConfiguration and MailProxyConfiguration:Transport

Signed-off-by: Julian Zehnter <pmg-devel@j-z.it>
Reviewed-By: Stoiko Ivanov <s.ivanov@proxmox.com>
Tested-By: Stoiko Ivanov <s.ivanov@proxmox.com>
2020-01-09 13:39:11 +01:00
Stoiko Ivanov
f03ead41f9 put login-window screenshot inside paragraph
with the recent change of including the screenshots with the
thumbnail attribute, the login-window screenshot was not rendered anymore

This happened because it was included directly above a list environment,
where the thumbnail attribute was not defined.

Additionally the big attribute was dropped.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-20 14:41:45 +01:00
Thomas Lamprecht
f019c41a91 bump version to 6.1-2
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-20 11:34:00 +01:00
Thomas Lamprecht
d210277a60 update static schema/synopsis definitions
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-20 11:33:25 +01:00
Thomas Lamprecht
f6249b79ef update installer scrots, add summary one
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-20 11:29:11 +01:00
Thomas Lamprecht
a695a527fd use big thumbnails for all screenshots
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-20 09:33:15 +01:00
Thomas Lamprecht
d108f53720 add big attribute to thumbnails
allows one to easily define bigger thumbnails, i.e., those where we
have to big images to show the full on a page, but still want to give
the user a good sized preview.

As PDF renders this already pretty nice by default we only have to
adapt the html asciidoc config. We do that by using asciidocs
"Conditional Attribute References"[0] and add a "big" attribute.

It can be used as:
> [thumbnail="pmg-gui-network-config.png", big=1]

NOTE: the value of big is ignored, it just matters if it's defined.
While it could be possible to add logic to handle big=0, it it's just
extra work without real use, just omit it if not wanted.

[0]: https://www.methods.co.nz/asciidoc/chunked/ch30.html

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-20 09:17:26 +01:00
Stoiko Ivanov
f5fddbffce add screenshots for dkim and custom SA score 2019-11-19 16:29:17 +01:00
Stoiko Ivanov
c484e56f73 update screenshots for PMG 6.1 2019-11-19 16:05:47 +01:00
Thomas Lamprecht
12f14b3aa7 bump version to 6.1-1
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-19 11:37:55 +01:00
Stoiko Ivanov
36b169e6b2 add documentation for custom sa scores
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-19 11:30:47 +01:00
Stoiko Ivanov
69a428d9b3 explain handling of sa configuration
The configuration files of spamassassin (/etc/mail/spamassassin) are provided
and changed by 2 things:
* some files are rendered through the templating engine
* the rest is shipped with proxmox-spamassassin on package upgrades

This patch explicitly lists the first category of files, clarifying the
situation for our users.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-19 11:30:47 +01:00
Stoiko Ivanov
89028579c2 Add documentation for before queue filtering
This patch adds the configuration options for before/after queue filtering
and generation of NDRs to the feature list and explains the concepts in
'pmgconfig.adoc' below the 'Options' panel of the MailProxy configuration
(where the features can be enabled in the GUI)

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-19 11:30:47 +01:00
Stoiko Ivanov
6441fbe909 mention DKIM Signing in the introduction
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-19 11:30:47 +01:00
Stoiko Ivanov
8b4756e58d add 'pmg-scores.cf' to config file section
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-19 11:30:47 +01:00
Stoiko Ivanov
5053eecce6 add dkim files to config file and cert section
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-19 11:30:47 +01:00
Thomas Lamprecht
08df0d3578 bump version to 6.0-5
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-15 13:01:18 +01:00
Thomas Lamprecht
d2f4977515 followup adaptions for SA custom rules
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-11-15 12:59:12 +01:00
Stoiko Ivanov
833e1edcb1 Expand the docs for custom SA configuration
Users regularly ask how to classify mails containing some keywords as spam.
Given that this usually indicates a misconfiguration in their DNS-Setup, and
the changes lead to more false positives than actually catching more spam
we should address this more explictly in the documentation.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-15 12:47:51 +01:00
Stoiko Ivanov
4ea3a20370 add before_queue params to gen-pmg.conf.5.-opts.pl
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-11-15 09:02:18 +01:00
Dominik Csapak
f7d90c0a22 add info about attachment quarantine
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2019-11-14 16:16:23 +01:00
Oguz Bektas
0c358d4574 pmgcm.adoc: improve wording and grammar
Signed-off-by: Oguz Bektas <o.bektas@proxmox.com>
2019-11-14 07:53:27 +01:00
Thomas Lamprecht
b458233401 bump version to 6.0-4
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-10-23 16:25:04 +02:00
Dietmar Maurer
3fe919103e fix path to dkim selecthor key 2019-10-23 11:58:17 +02:00
Stoiko Ivanov
20522d9644 Add DKIM documentation
Add a short section explaining DKIM and the specifics of Signing in PMG.

Additionally gen-pmg.conf.5-opts.pl was extended to create
'pmg.admin-dkim-conf-opts.adoc' for inclusion below the documentation.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-10-23 11:52:41 +02:00
Thomas Lamprecht
79569792fd repos: change security repo link for future proofing and add note for bullseye
Actual this is a no-change change, as they URLs both resolve to the
exact same folders (are symlinked), i.e., see:

http://security-cdn.debian.org/dists/
vs.
http://security-cdn.debian.org/debian-security/dists/

but just change it nonetheless to match Debian's recommendation.
Also, add a FIXME not for the future 7.0 as there we need to change
the security suite name too[0].

[0]: https://lists.debian.org/debian-devel-announce/2019/07/msg00004.html

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-10-08 11:45:55 +02:00
Stoiko Ivanov
af0f180077 mail-filter: include 'Rule-Based' in heading
One of the core features of PMG is the rule-system, which is documented in
'pmg-mail-filter.adoc' under the (correct) heading of 'Mail Filter'

In quite a few other places [0,1] where the features of PMG are highlighted we
refer to the (Object Oriented) Rule System.

When skimming through the documentation and quickly glancing at links the
connection 'Rule System' <-> 'Mail Filter' is not directly apparent and could
cause confusion.

This is addressed by adding 'Rule-Based' as prefix to the chapter title.

[0] https://www.proxmox.com/en/proxmox-mail-gateway/features
[1] https://pmg.proxmox.com/pmg-docs/pmg-admin-guide.html#_features

Reported-by: Daniela Häsler <daniela@proxmox.com>
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-09-05 16:27:05 +02:00
Dominik Csapak
0fcf4fde15 add the supported browsers to the system requirements
copied from pve

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
2019-09-05 16:26:19 +02:00
Thomas Lamprecht
e674ddb897 bump version to 6.0-3
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-23 13:14:00 +02:00
Thomas Lamprecht
be5f2f9d77 add mailgateway FAQ similar to the PVE one
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-23 13:14:00 +02:00
Thomas Lamprecht
6a73cfb05a run make update for new schema and synopsis definition
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-23 12:13:17 +02:00
Stoiko Ivanov
8686c16175 change api-viewer title to PMG
noted while testing the use of our extjs-package instead of cloudflare cdn
(ddc224d888).

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-08-21 16:50:29 +02:00
Stoiko Ivanov
40f0b774ef fix lintian warning in pmg-docs-apache
the apache/conf-available snippet for pmg-docs-apache should be named like the
package according to lintian (non-standard-apache2-configuration-name).

move the configfile via dpkg-maintscript-helper(1) (see the manpage for
the explaination of the prior version of 6.0-3~) and dh_installdeb(1).

Tested by upgrading pmg-docs-apache to a version with this commit, while having
modifications in '/etc/apache2/conf-available/pmg-docs.conf'

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-08-21 16:50:29 +02:00
Stoiko Ivanov
5f3e8256b7 pmg-docs-apache: remove default redirect
pmg.proxmox.com does not host only the documentation the default redirect
to '/pmg-docs' should be removed

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-08-21 16:50:29 +02:00
Thomas Lamprecht
45c2ae5253 bump version to 6.0-2
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-17 13:08:25 +02:00
Thomas Lamprecht
27173cd7e3 api-viewer: properly HTML encode properties
and fix missing closing </pre> tag

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-17 12:53:19 +02:00
Thomas Lamprecht
ddc224d888 api-viewer: use our extjs package instead of the cloudflare cdn
The loading of an external hosted ExtJS is from a time where we did
not have a extra ExtJS package as it still was in the pve-manager
one, which was not desired to be installed on a non-pmg machine.
Add a dependency on libjs-extjs and a link from api-viewer/extjs to
the installation directory of the ExtJS package, this allows to reuse
ExtJS on PMG node hosted docs and on the hosted docs from proxmox.com
at the same time.

Adapted from the Proxmox VE version[0] of this change.

[0]: https://git.proxmox.com/?p=pve-docs.git;a=commitdiff;h=e56030c4d7c3bd0de1ebc109d528fb6b7bef05a3

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-17 12:48:25 +02:00
Thomas Lamprecht
241ac83c45 run 'make update'
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-08-17 11:52:00 +02:00
Stoiko Ivanov
39abbce413 add anchors needed for the upgrade documentation
Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-08-14 10:29:35 +02:00
Stoiko Ivanov
7cf7c2d3ee change repository urls to buster
and adapt the location of the signing key and its hashsums.

Signed-off-by: Stoiko Ivanov <s.ivanov@proxmox.com>
2019-08-14 10:26:43 +02:00
Thomas Lamprecht
bf5e24a7b7 bump version to 6.0-1
Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-07-23 19:44:16 +02:00
Thomas Lamprecht
1e94bc8164 make changelog single source of version
Adapted from pve-docs respective commit [0]

[0]: https://git.proxmox.com/?p=pve-docs.git;a=commitdiff;h=76909adf48fc211e7799795fcb96eed5447e2b9a

Signed-off-by: Thomas Lamprecht <t.lamprecht@proxmox.com>
2019-07-23 19:43:15 +02:00