Переглянути джерело

Update docs for DNS settings: Postmoogle

Remove the table from configuring-dns.md altogether

Signed-off-by: Suguru Hirahara <acioustick@noreply.codeberg.org>
pull/3936/head
Suguru Hirahara 1 рік тому
джерело
коміт
e97e8fec8d
Не вдалося знайти GPG ключ що відповідає даному підпису Ідентифікатор GPG ключа: E4F9743DAB4B7B75
2 змінених файлів з 13 додано та 19 видалено
  1. +0
    -15
      docs/configuring-dns.md
  2. +13
    -4
      docs/configuring-playbook-bridge-postmoogle.md

+ 0
- 15
docs/configuring-dns.md Переглянути файл

@@ -38,21 +38,6 @@ Be mindful as to how long it will take for the DNS records to propagate.


If you are using Cloudflare DNS, make sure to disable the proxy and set all records to "DNS only". Otherwise, fetching certificates will fail. If you are using Cloudflare DNS, make sure to disable the proxy and set all records to "DNS only". Otherwise, fetching certificates will fail.


## DNS settings for optional services/features

For other services which may need subdomain settings, see the table below and configure the DNS (`CNAME`) records accordingly.

| Used by component | Type | Host | Priority | Weight | Port | Target |
| -------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------------------ | -------- | ------ | ---- | -----------------------------------|
| [Postmoogle](configuring-playbook-bridge-postmoogle.md)/[Email2Matrix](configuring-playbook-email2matrix.md) email bridges | MX | `matrix` | 10 | 0 | - | `matrix.example.com` |
| [Postmoogle](configuring-playbook-bridge-postmoogle.md) email bridge | TXT | `matrix` | - | - | - | `v=spf1 ip4:matrix-server-IP -all` |
| [Postmoogle](configuring-playbook-bridge-postmoogle.md) email bridge | TXT | `_dmarc.matrix` | - | - | - | `v=DMARC1; p=quarantine;` |
| [Postmoogle](configuring-playbook-bridge-postmoogle.md) email bridge | TXT | `postmoogle._domainkey.matrix` | - | - | - | get it from `!pm dkim` |

### MX and TXT records for Postmoogle

To make Postmoogle enable its email sending features, you need to configure MX and TXT (SPF, DMARC, and DKIM) records. See the table above for values which need to be specified.

--------------------------------------------- ---------------------------------------------


[▶️](getting-the-playbook.md) When you're done with the DNS configuration and ready to proceed, continue with [Getting the playbook](getting-the-playbook.md). [▶️](getting-the-playbook.md) When you're done with the DNS configuration and ready to proceed, continue with [Getting the playbook](getting-the-playbook.md).

+ 13
- 4
docs/configuring-playbook-bridge-postmoogle.md Переглянути файл

@@ -19,6 +19,19 @@ If you don't open these ports, you will still be able to send emails, but not re


These port numbers are configurable via the `matrix_postmoogle_smtp_host_bind_port` and `matrix_postmoogle_submission_host_bind_port` variables, but other email servers will try to deliver on these default (standard) ports, so changing them is of little use. These port numbers are configurable via the `matrix_postmoogle_smtp_host_bind_port` and `matrix_postmoogle_submission_host_bind_port` variables, but other email servers will try to deliver on these default (standard) ports, so changing them is of little use.


## Adjusting DNS records

To make Postmoogle enable its email sending features, you need to configure MX and TXT (SPF, DMARC, and DKIM) records. See the table below for values which need to be specified.

| Type | Host | Priority | Weight | Port | Target |
|------|--------------------------------|----------|--------|------|------------------------------------|
| MX | `matrix` | 10 | 0 | - | `matrix.example.com` |
| TXT | `matrix` | - | - | - | `v=spf1 ip4:matrix-server-IP -all` |
| TXT | `_dmarc.matrix` | - | - | - | `v=DMARC1; p=quarantine;` |
| TXT | `postmoogle._domainkey.matrix` | - | - | - | get it from `!pm dkim` |

**Note**: the DKIM record can be retrieved after configuring and installing the bridge's bot.

## Adjusting the playbook configuration ## Adjusting the playbook configuration


Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file: Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:
@@ -42,10 +55,6 @@ matrix_postmoogle_password: PASSWORD_FOR_THE_BOT
# matrix_admin: '@yourAdminAccount:{{ matrix_domain }}' # matrix_admin: '@yourAdminAccount:{{ matrix_domain }}'
``` ```


## Adjusting DNS records

You will also need to add several DNS records so that Postmoogle can send emails. See [Configuring DNS](configuring-dns.md) for details about DNS changes.

## Installing ## Installing


After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below: After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:


Завантаження…
Відмінити
Зберегти