This repository has been archived on 2024-01-30. You can view files and clone it, but cannot push or open issues or pull requests.
docs/content/mail.md
stuebinm ad7b0aea0f add usable stuff from bookstack
the rest is sufficiently out of date that keeping the documentation would
be actively harmful.
2022-01-06 00:25:37 +01:00

70 lines
2.2 KiB
Markdown

+++
title = "services/mail"
taxonomies.categories = [ "services" ]
+++
- runs on: parsons
- purpose: sending mails
- maintainer: ?
- configuration: [nix file](https://gitlab.infra4future.de/infra/haccfiles/-/blob/main/services/mail.nix)
- login: passwords defined in nixfile
## adding a mail account
* We use `@hacc.space` for our mails
* `@infra4future.de` is reserved for services, old user accounts will be forwarded & logins disabled
* choose a name (no aliases or other names can be the same)
* generate a sha-512 password hash ```mkpasswd -m sha-512``` - **never add an unhashed password!**
* add your accunt to ```loginAccounts =``` in the [nix file](https://gitlab.infra4future.de/infra/haccfiles/-/blob/main/services/mail.nix#L16)
* build and redeploy parsons
**example:**
```
zwoelfontheshelf@hacc.space" = {
hashedPassword = "$6$ISAaU8X6D$oGKe9WXDWrRpGzHUEdxrxdtgvzuGOkBMuDc82IZhegpsv1bqd550FhZZrI40IjZTA5Hy2MZ8j/0efpnQ4fOQH0";
};
```
## adding to a forward adress
* add the mail address to the coresponding `extraVirtualAliases =` in the [nix file](https://gitlab.infra4future.de/infra/haccfiles/-/blob/main/services/mail.nix#L80)
* build and redeploy parsons
## adding a forward adress
* add the address to `extraVirtualAliases =` in the [nix file](https://gitlab.infra4future.de/infra/haccfiles/-/blob/main/services/mail.nix#L80)
* add the addresses it should forward to
* build and redeploy parsons
**example:**
```
"himmel@hacc.space" = [
"hexchen@hacc.space"
"schweby@hacc.space"
"zauberberg@hacc.space"
];
```
## sending & reciveing mail
### as a user
* Your mail client should auto configure correctly
```
mailserver: mail.hacc.space (everywhere)
username: $your_mail_address
sending via smtp: port 587 or 465
recieving
imap: port 993
TLS and STARTTLS are supported
```
* You can send mail as you and any alias you recieve mail from. Set a second Identity in your e-mail client
### as an application
* If your application needs to recieve mail, please talk to a maintainer first.
* mailserver: `mail.hacc.space`
* Do **not** use port 25. It's for server to server communication only.
* Use smtp ports `587` or `465`
* enable TLS if possible
* only send mail from `noreply@infra4future.de`
* Password is in vaultwarden (TODO?)