Files
ansible-role-rspamd/README.md
Markus Pesch e62397b06f
Some checks failed
Ansible Linter / ansible-lint (push) Failing after 18s
Lint Markdown files / markdown-lint (push) Successful in 5s
Initial Commit
2026-03-02 18:56:57 +01:00

63 lines
2.1 KiB
Markdown

# volker-raschek.rspamd
![Ansible Role](https://img.shields.io/ansible/role/d/volker-raschek/rspamd)
The ansible role `volker-raschek.rspamd` install rspamd - a spam milter. For example for Arch Linux, Fedora and Ubuntu.
Furthermore, rspamd can be integration in some MTA's like postfix.
## Examples
The following configuration enables DKIM signature validation and redis as backend. Furthermore, it configures custom
DNS servers for DNS queries.
```yaml
## @param rspamd_dkim_enabled Create `dkim_sining.conf`.
## @param rspamd_dkim_domains DKIM Domain configuration.
rspamd_dkim_enabled: true
rspamd_dkim_domains:
- name: my.example.local
selector: "2020"
## @section DNS
## @param List of DNS servers used for DNS lookups.
rspamd_dns_servers:
- 8.8.4.4
- 8.8.8.8
## @section Redis
## https://docs.rspamd.com/configuration/redis/#available-redis-options
## @param rspamd_redis_database Number of redis database.
## @param rspamd_redis_password Password to connect to redis.
## @param rspamd_redis_username Username to connect to redis.
## @param rspamd_redis_servers List of upstream redis server for read and write requests.
## @param rspamd_redis_timeout Timeout in seconds to get reply from redis. For example `0.5s`, `1min`.
## @param rspamd_redis_disabled_modules List of disabled modules.
rspamd_redis_enabled: true
rspamd_redis_database: "0"
rspamd_redis_password: "my-password"
rspamd_redis_username: "my-username"
rspamd_redis_servers:
- "127.0.0.1"
rspamd_redis_timeout: "5s"
rspamd_redis_disabled_modules:
- "ratelimit"
```
## Further ansible roles
This ansible role is used in combination with other ansible roles of `volker-raschek`. You can search for the other
ansible roles via the following command.
```bash
$ ansible-galaxy role search --author "volker-raschek"
Found roles matching your search:
Name Description
---- -----------
volker-raschek.bind9 Role to install and configure bind9 on different distributions
volker-raschek.dhcpd Role to install and configure dhcpd on different distributions
volker-raschek.renovate Role to configure renovate as container image
...
```