|
Size: 1825
Comment:
|
Size: 1842
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 17: | Line 17: |
| To route outbound email (i.e. automated notifications), Sourcehut needs to run alongside some [[Email/MailTransferAgent|MTA]]. | To route outbound email (i.e. automated notifications), Sourcehut needs to run alongside some [[Email/MTA|MTA]]. |
| Line 48: | Line 48: |
| Sourcehut requires a PGP key to send mail by SMTP. In the Sourcehut configuration file: | Sourcehut requires a PGP key to send mail by [[Protocols/SMTP|SMTP]]. In the Sourcehut configuration file: |
| Line 56: | Line 56: |
| The private key must be password-less. For instructions on exporting keys to files and removing passwords from keys, see [[GPG#Usage|GPG]]. | The private key must be password-less. For instructions on exporting keys to files and removing passwords from keys, see [[Encryption/GPG#Usage|GPG]]. |
| Line 62: | Line 62: |
| For the `todo.sr.ht-lmtp` service to receive and process inbound mail, Sourcehut needs to run alongside some mail agent. LMTP is inherently a queue-less protocol, so either a [[Email/MailDeliveryAgent|MDA]] or [[Email/MailTransferAgent|MTA]] will be sufficient. Because an MTA is already necessary for administering Sourcehut, it's recommended to simply re-use it. | For the `todo.sr.ht-lmtp` service to receive and process inbound mail, Sourcehut needs to run alongside some mail agent. [[Email/LMTP|LMTP]] is inherently a queue-less protocol, so either a [[Email/MDA|MDA]] or [[Email/MailTransferAgent|MTA]] will be sufficient. Because an MTA is already necessary for administering Sourcehut, it's recommended to simply re-use it. |
Sourcehut Mail
The Sourcehut software environment makes extensive use of email as a communication protocol.
Contents
Configuration
SMTP
To route outbound email (i.e. automated notifications), Sourcehut needs to run alongside some MTA.
If a mail server is running locally, a valid option is to connect without encryption or authentication. In the Sourcehut configuration file:
[mail] smtp-host=localhost smtp-port=25 smtp-from=root@localhost smtp-encryption=insecure smtp-auth=none
If encryption is necessary, try:
smtp-encryption=starttls
If authentication is necessary, try:
smtp-auth=plain smtp-user=myuser smtp-password=mypassword
PGP
Sourcehut requires a PGP key to send mail by SMTP. In the Sourcehut configuration file:
pgp-privkey=/etc/sr.ht/pgp.key pgp-pubkey=/etc/sr.ht/pgp.pubkey pgp-key-id=KEYID
The private key must be password-less. For instructions on exporting keys to files and removing passwords from keys, see GPG.
LMTP
For the todo.sr.ht-lmtp service to receive and process inbound mail, Sourcehut needs to run alongside some mail agent. LMTP is inherently a queue-less protocol, so either a MDA or MTA will be sufficient. Because an MTA is already necessary for administering Sourcehut, it's recommended to simply re-use it.
In the todo.sr.ht::mail section of the Sourcehut configuration file:
[todo.sr.ht::mail] sock=/tmp/todo.sr.ht-lmtp.sock sock-group=mtauser posting-domain=localhost.localdomain
As an example, if running Postfix as an MTA, set sock-group to postfix.