Commit Graph

2751 Commits

Author SHA1 Message Date
polarathene e5ed128dd6 docs: Revise and expand supplementary pages
Better outline the OAuth2 login process, the two supported login mechanisms and their docs/rfcs, along with documenting caveat with mail client compatibility.

Add a verification tip for the OAuth2 support, showing how `curl` can be used, along with caveat presently affecting the `curl` in DMS v14.

Additionally note the feature still isn't documented fully, providing the user with additional references for more information.

`ACCOUNT_PROVISIONER` ENV docs minimized. No `OIDC` provisioner plans, the OAuth2 docs page now mentions SCIM 2.0 API as the next step towards resolving that concern. The tip admonition was removed as it no longer provides value, instead we link to the Account Management overview page.

Dovecot Master Accounts docs page now lightly document the `setup` CLI and config format for the feature.
2024-07-19 18:39:16 +12:00
polarathene 750d6e5ab4 docs: Document `postfix-accounts.cf` third column
This lacked documentation but was community contributed feature to allow further customization of a Dovecot Account.

It has caveats as DMS does not take these into consideration anywhere in scripts. Documenting officially for better awareness.
2024-07-19 18:06:35 +12:00
polarathene e25c32b7fd docs(chore): Shift sub-addressing section
This is related to accounts and aliases, but not provisioners, thus extract out of the accounts parent section.
2024-07-19 18:06:34 +12:00
polarathene 5286f09683 docs: Another revision pass
File based provisioner docs:
- Sections indent with info admonitions.
- Accounts section expanded with config format and example.
- Quotas section expanded and shifted to bottom (alphabetical sort).
- Split into `setup` CLI and config reference groups.

Overview page:
- Sections indent with info admonitions.
- Revised content.
2024-07-19 18:06:34 +12:00
polarathene d88d637475 docs: Revise accounts overview section
Revised the account section and added additional clarity for common confusion with relation to sender address and multi-domain support.

Top of the page now clarifies it's a technical reference and directs users to the related pages for configuration / caveats.

Technical Overview links to Dovecot docs were missing.
2024-07-19 18:06:34 +12:00
polarathene 6a10759ff8 docs: Sieve minor revisions
- Correct link to subaddressing section
- Make the config file example snippets intended filename less ambiguous.
- Minor rephrasng.
2024-07-19 18:06:34 +12:00
polarathene 652c7967d0 docs: OAuth2 revision
Minor update to this page:
- Links extracted to bottom of page as per convention.
- ENV file example converted to preferred `compose.yaml` ENV settings.
2024-07-19 18:06:34 +12:00
polarathene 2d86c3d9a1 docs: Refactor master accounts page
This rewrite should more clearly document the feature, along with a better example and additional links for reference.
2024-07-19 18:06:34 +12:00
polarathene 91c4b1794b docs: Alias section refactor
Extensively covers known issues and technical details that have been discussed often enough.

The improvements should benefit both users and maintainers.
2024-07-19 18:06:34 +12:00
polarathene 9edf90f86d docs: Revise the quota section
Minor revisions with phrasing, admonitions for structure and better explanation of the feature functionality/purpose.
2024-07-19 18:06:33 +12:00
polarathene 6e9c6b8503 docs: Refactor the quota section
Better documented with links and coverage over the workaround details we've implemented.
2024-07-19 18:06:33 +12:00
polarathene b7c5ff3bd2 docs: Minor adjustments 2024-07-19 18:06:33 +12:00
polarathene 29d702362f docs: Revise accounts section
Add some context regarding DMS accounts and their distinction/overlap from the email address functionality, and it's relevant context for receiving/sending.

File provisioner, minor revisions to referencing associated config files and account management.
2024-07-19 18:06:33 +12:00
polarathene 3ad4a359e3 docs(refactor): Sub-addressing section
Much better docs on the sub-addressing feature supported by Postfix and Dovecot, along with the guidance with usage in Sieve.
2024-07-19 18:06:33 +12:00
polarathene 28ca7d3141 chore: Temporary commit 2024-07-19 18:06:33 +12:00
polarathene e8260d7523 docs: Accounts (File) - Refactor
- Manual method not necessary to document.
- Condense `setup` example guidance.
- Quotas / Aliases content migrated to Overview when not specific about file provisioner.

Some of the content is this commit is not a complete revision.
2024-07-19 18:06:33 +12:00
polarathene f0fb63ca31 docs: Fix highlighting roundcube PHP snippet in OAuth2 page 2024-07-19 18:06:32 +12:00
polarathene 8a360b76db docs: Accounts (Dovecot Master) - Minor revisions 2024-07-19 18:06:32 +12:00
polarathene b0be164e15 docs: Correct relocated pages titles and links 2024-07-19 18:06:32 +12:00
polarathene cce0771b73 docs: Add account management overview page
Updates remaining links to account sections on this page instead (_for `accounts`, `aliases`, `quotas`_).

This page will cover the features and defer to separate pages for more specific content where relevant.
2024-07-19 18:06:32 +12:00
polarathene 9d88ab724e docs: Update references to relocated pages 2024-07-19 18:06:32 +12:00
polarathene a214d70ebe docs: Relocate account / auth pages into a common section 2024-07-19 18:06:32 +12:00
Brennan Kinney c5f125c973
tests: Update `curl` note for XOAUTH2 support (#4118) 2024-07-18 10:31:50 +12:00
dependabot[bot] 34423c2f66
chore(deps): Bump docker/build-push-action from 6.3.0 to 6.4.0 (#4113)
Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 6.3.0 to 6.4.0.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v6.3.0...v6.4.0)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-16 01:44:17 +00:00
dependabot[bot] bf4ebc2a41
chore(deps): Bump anchore/scan-action from 3.6.4 to 4.0.0 (#4114)
Bumps [anchore/scan-action](https://github.com/anchore/scan-action) from 3.6.4 to 4.0.0.
- [Release notes](https://github.com/anchore/scan-action/releases)
- [Changelog](https://github.com/anchore/scan-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/anchore/scan-action/compare/v3.6.4...v4.0.0)

---
updated-dependencies:
- dependency-name: anchore/scan-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-16 13:42:20 +12:00
Brennan Kinney 755540cacf
docs: `docker-build.md` - Update `DOVECOT_COMMUNITY_REPO` default (#4111) 2024-07-14 11:24:33 +02:00
Brennan Kinney 4778f15fda
docs: TLS typo fix (#4106)
- Caddy admonition - Missing `[` for annotating a link.
- Traefik - `docker-compose` => "Docker Compose"
2024-07-09 19:44:09 +02:00
dependabot[bot] 3a40c457fc
chore(deps): Bump docker/setup-qemu-action from 3.0.0 to 3.1.0 (#4105)
Bumps [docker/setup-qemu-action](https://github.com/docker/setup-qemu-action) from 3.0.0 to 3.1.0.
- [Release notes](https://github.com/docker/setup-qemu-action/releases)
- [Commits](https://github.com/docker/setup-qemu-action/compare/v3.0.0...v3.1.0)

---
updated-dependencies:
- dependency-name: docker/setup-qemu-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-08 23:26:20 +00:00
dependabot[bot] 2cca907615
chore(deps): Bump docker/setup-buildx-action from 3.3.0 to 3.4.0 (#4104)
Bumps [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) from 3.3.0 to 3.4.0.
- [Release notes](https://github.com/docker/setup-buildx-action/releases)
- [Commits](https://github.com/docker/setup-buildx-action/compare/v3.3.0...v3.4.0)

---
updated-dependencies:
- dependency-name: docker/setup-buildx-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-08 23:24:48 +00:00
dependabot[bot] 19d52d9dcc
chore(deps): Bump docker/build-push-action from 6.2.0 to 6.3.0 (#4103)
Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 6.2.0 to 6.3.0.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v6.2.0...v6.3.0)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-09 11:23:02 +12:00
Brennan Kinney 2d12bbb7fd
docs: Update `compose.yaml` for `dovecot-solr` guide (#4099)
The `image` field is used for the default tag, if it's not specified Compose will infer one in addition to any extra `tags` provided.

Better to use `image` for the tag assignment, and a clear `pull_policy` to prevent trying to pull a remote image of the same name.
2024-07-05 23:48:42 +12:00
Brennan Kinney 9175424d0f
fix: Update `dovecot-fts-xapian` to `1.7.13` (#4095)
* fix: Update `dovecot-fts-xapian` to `1.7.13`

Contains a fix to a regression introduced that broke indexing

---------

Co-authored-by: casperklein <casperklein@users.noreply.github.com>
2024-07-03 22:16:02 +12:00
dependabot[bot] b3a5e9e4e8
chore(deps): Bump docker/build-push-action from 6.1.0 to 6.2.0 (#4089)
Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 6.1.0 to 6.2.0.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v6.1.0...v6.2.0)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-07-03 12:17:19 +12:00
Georg Lauterbach 22383c28e7
CI: Remove reviewer assignment from Dependabot config (#4088) 2024-06-30 11:34:38 +02:00
github-actions[bot] 5a4a136ec5
docs: updated `CONTRIBUTORS.md` (#4084)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2024-06-29 12:44:00 +02:00
dependabot[bot] ccaa02b8b5
chore(deps): Bump docker/build-push-action from 6.0.0 to 6.1.0 (#4086) 2024-06-25 22:43:10 +02:00
Casper e370c0c96a
fail2ban install: remove -k (--insecure) from curl options (#4080) 2024-06-19 18:34:18 +02:00
Brennan Kinney 8a082be714
docs: Add info regarding DKIM key rotation and non-expiry (#4076)
Co-authored-by: Georg Lauterbach <44545919+georglauterbach@users.noreply.github.com>
Co-authored-by: Casper <casperklein@users.noreply.github.com>
2024-06-19 08:39:06 +00:00
Casper d7dab2d20d
feat: Add password confirmation (#4072)
Co-authored-by: Georg Lauterbach <44545919+georglauterbach@users.noreply.github.com>
2024-06-19 06:10:00 +00:00
dependabot[bot] 98cbcfc171
chore(deps): Bump docker/build-push-action from 5.4.0 to 6.0.0 (#4074)
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Casper <casperklein@users.noreply.github.com>
2024-06-18 22:30:24 +00:00
beertje44 40aab6bd18
docs: Add tutorial for configuring Dovecot FTS with Solr (#4070)
Describe how to use Apache Solr as a Dovecot FTS backend.

---------

Co-authored-by: Casper <casperklein@users.noreply.github.com>
Co-authored-by: Georg Lauterbach <44545919+georglauterbach@users.noreply.github.com>
Co-authored-by: Brennan Kinney <5098581+polarathene@users.noreply.github.com>
2024-06-18 08:46:34 +02:00
github-actions[bot] e4aff5531e
docs: updated `CONTRIBUTORS.md` (#4069)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2024-06-16 18:36:10 +02:00
Brennan Kinney 8e32635993
docs: Document fix for PROXY protocol with `postscreen` (#4066) 2024-06-15 14:26:33 +02:00
dependabot[bot] e6713a0aec
chore(deps): Bump docker/build-push-action from 5.3.0 to 5.4.0 (#4062)
Bumps [docker/build-push-action](https://github.com/docker/build-push-action) from 5.3.0 to 5.4.0.
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v5.3.0...v5.4.0)

---
updated-dependencies:
- dependency-name: docker/build-push-action
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2024-06-11 14:33:57 +12:00
mmehnert 5c798e6829
Update logwatch ignore.conf to exclude Xapian messages about pending documents (#4060)
Co-authored-by: Brennan Kinney <5098581+polarathene@users.noreply.github.com>
2024-06-09 15:12:49 +02:00
Casper 18d9d1adcc
Fail2ban 1.1.0 (#4045) 2024-06-08 13:43:25 +02:00
Brennan Kinney f1df81a7e4
docs: `mailserver.env` improve description for `SPAM_SUBJECT` (#4050)
Co-authored-by: Casper <casperklein@users.noreply.github.com>
2024-06-07 18:42:05 +12:00
Georg Lauterbach eb165ded65
prepare v14.0.0 release (#4013)
Co-authored-by: Casper <casperklein@users.noreply.github.com>
2024-06-05 17:14:35 +02:00
github-actions[bot] e78d5c61ee
docs: updated `CONTRIBUTORS.md` (#4043) 2024-06-03 08:35:07 +02:00
Georg Lauterbach f8b3f40276
scripts: update log format (#4035)
Co-authored-by: Brennan Kinney <5098581+polarathene@users.noreply.github.com>
2024-05-29 12:28:51 +12:00