mirror of
https://github.com/spantaleev/matrix-docker-ansible-deploy.git
synced 2024-12-29 12:27:14 +01:00
138 lines
6.3 KiB
Plaintext
138 lines
6.3 KiB
Plaintext
# SOME DESCRIPTIVE TITLE.
|
|
# Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community members
|
|
# This file is distributed under the same license as the matrix-docker-ansible-deploy package.
|
|
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
|
|
#
|
|
#, fuzzy
|
|
msgid ""
|
|
msgstr ""
|
|
"Project-Id-Version: matrix-docker-ansible-deploy \n"
|
|
"Report-Msgid-Bugs-To: \n"
|
|
"POT-Creation-Date: 2024-12-20 09:53+0200\n"
|
|
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
|
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
|
"Language-Team: LANGUAGE <LL@li.org>\n"
|
|
"MIME-Version: 1.0\n"
|
|
"Content-Type: text/plain; charset=UTF-8\n"
|
|
"Content-Transfer-Encoding: 8bit\n"
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:1
|
|
msgid "Setting up Postmoogle email bridging (optional)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:3
|
|
msgid "**Note**: email bridging can also happen via the [email2matrix](configuring-playbook-email2matrix.md) bridge supported by the playbook."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:5
|
|
msgid "The playbook can install and configure [Postmoogle](https://github.com/etkecc/postmoogle) for you."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:7
|
|
msgid "Postmoogle is a bridge you can use to have its bot user forward emails to Matrix rooms. It runs an SMTP email server and allows you to assign mailbox addresses to the rooms."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:9
|
|
msgid "See the project's [documentation](https://github.com/etkecc/postmoogle/blob/master/README.md) to learn what it does and why it might be useful to you."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:11
|
|
msgid "Prerequisites"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:13
|
|
msgid "Open the following ports on your server to be able to receive incoming emails:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:15
|
|
msgid "`25/tcp`: SMTP"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:16
|
|
msgid "`587/tcp`: Submission (TLS-encrypted SMTP)"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:18
|
|
msgid "If you don't open these ports, you will still be able to send emails, but not receive any."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:20
|
|
msgid "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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:22
|
|
msgid "Adjusting the playbook configuration"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:24
|
|
msgid "Add the following configuration to your `inventory/host_vars/matrix.example.com/vars.yml` file:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:45
|
|
msgid "Adjusting DNS records"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:47
|
|
msgid "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."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:49
|
|
msgid "Installing"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:51
|
|
msgid "After configuring the playbook, run it with [playbook tags](playbook-tags.md) as below:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:58
|
|
msgid "**Notes**:"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:60
|
|
msgid "The `ensure-matrix-users-created` playbook tag makes the playbook automatically create a user account of the bridge's bot."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:62
|
|
msgid "The shortcut commands with the [`just` program](just.md) are also available: `just install-all` or `just setup-all`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:64
|
|
msgid "`just install-all` is useful for maintaining your setup quickly ([2x-5x faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-runtime) than `just setup-all`) when its components remain unchanged. If you adjust your `vars.yml` to remove other components, you'd need to run `just setup-all`, or these components will still remain installed."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:66
|
|
msgid "If you change the bridge's bot password (`matrix_postmoogle_password` in your `vars.yml` file) subsequently, the bot user's credentials on the homeserver won't be updated automatically. If you'd like to change the bot user's password, use a tool like [synapse-admin](configuring-playbook-synapse-admin.md) to change it, and then update `matrix_postmoogle_password` to let the bot know its new password."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:68
|
|
msgid "Usage"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:70
|
|
msgid "To use the bridge, invite the `@postmoogle:example.com` bot user into a room you want to use as a mailbox."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:72
|
|
msgid "Then send `!pm mailbox NAME` to expose this Matrix room as an inbox with the email address `NAME@matrix.example.com`. Emails sent to that email address will be forwarded to the room."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:74
|
|
msgid "Send `!pm help` to the room to see the bridge's help menu for additional commands."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:76
|
|
msgid "You can also refer to the upstream [documentation](https://github.com/etkecc/postmoogle)."
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:78
|
|
msgid "Debug/Logs"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:80
|
|
msgid "As with all other services, you can find their logs in [systemd-journald](https://www.freedesktop.org/software/systemd/man/systemd-journald.service.html) by running something like `journalctl -fu matrix-postmoogle`"
|
|
msgstr ""
|
|
|
|
#: ../../../docs/configuring-playbook-bridge-postmoogle.md:82
|
|
msgid "The default logging level for this bridge is `INFO`, but you can increase it to `DEBUG` with the following additional configuration:"
|
|
msgstr ""
|