c3dc64b1d5
We no longer ask users to create Matrix user accounts for these bots: - Postmoogle - Honoroit - Reminder Bot Other bots and services (matrix-registration-bot, maubot, mjolnir, Dimension, etc.) require an Access Token to run (not a password), so this new role doesn't help for them. It does help for the above bots though, and for defining your own "initial user accounts" in the `matrix_user_creator_users_additional` variable.
2.2 KiB
Setting up Postmoogle (optional)
Note: email bridging can also happen via the email2matrix bridge supported by the playbook.
The playbook can install and configure Postmoogle for you.
It's a bot/bridge you can use to forward emails to Matrix rooms
See the project's documentation to learn what it does and why it might be useful to you.
Adjusting the playbook configuration
Add the following configuration to your inventory/host_vars/matrix.DOMAIN/vars.yml file:
matrix_bot_postmoogle_enabled: true
# Uncomment and adjust this part if you'd like to use a username different than the default
# matrix_bot_postmoogle_login: postmoogle
# Generate a strong password here. Consider generating it with `pwgen -s 64 1`
matrix_bot_postmoogle_password: PASSWORD_FOR_THE_BOT
You will also need to add several DNS records so that postmoogle can send emails. See Configuring DNS.
Installing
After configuring the playbook, run the installation command again:
ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,ensure-matrix-users-created,start
Notes:
-
the
ensure-matrix-users-createdplaybook tag makes the playbook automatically create the bot's user account -
if you change the bot password (
matrix_bot_postmoogle_passwordin yourvars.ymlfile) 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 to change it, and then updatematrix_bot_postmoogle_passwordto let the bot know its new password
Usage
To use the bot, invite the @postmoogle:DOMAIN into a room you want to use as a mailbox.
Then send !pm mailbox NAME to expose this Matrix room as an inbox with the email address NAME@matrix.domain. Emails sent to that email address will be forwarded to the room.
Send !pm help to the room to see the bot's help menu for additional commands.
You can also refer to the upstream documentation.