matrix-docker-ansible-deploy/i18n/translation-templates/docs/configuring-playbook-bridge-postmoogle.pot

138 lines
6.2 KiB
Plaintext
Raw Normal View History

# 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 07:23+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) 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 ""