mirror of https://github.com/de-it-krachten/ansible-role-opendkim synced 2026-05-14 03:41:50 +00:00

No description

Jinja 100%

Find a file

semantic-release-bot cf35f6e523 chore(release): 1.8.0 [skip ci] # [1.8.0](https://github.com/de-it-krachten/ansible-role-opendkim/compare/v1.7.0...v1.8.0) (2025-08-06) ### Features * Add support for AlmaLinux 10 ([`39e8895`](`39e88955cd`)) * Add support for Debian 13 (Trixie) ([`6eff58e`](`6eff58e713`)) * Add support for OracleLinux 10 ([`cdc5a3e`](`cdc5a3e022`)) * Add support for Red Hat Enterprise Linux 10 ([`000681d`](`000681d60c`)) * Add support for RockyLinux 10 ([`87c063b`](`87c063bd75`))		2025-08-06 22:03:06 +00:00
.github/workflows	Update supported platforms & CI	2025-08-06 20:53:37 +02:00
defaults	feat: Update supported platforms & CI	2023-09-17 22:13:15 +02:00
handlers	feat: Move to FQCN	2022-10-09 21:32:27 +02:00
meta	Update supported platforms & CI	2025-08-06 20:53:37 +02:00
molecule/default	Update supported platforms & CI	2025-08-06 20:53:37 +02:00
tasks	feat: Update supported platforms & CI	2023-09-17 22:13:15 +02:00
.ansible-lint	feat: Update CI to latest standards	2022-10-09 23:48:42 +02:00
.cicd	Update supported platforms & CI	2025-08-06 20:53:37 +02:00
.cicd.overwrite	feat: Update supported platforms & CI	2023-09-17 22:13:15 +02:00
.collections	feat: Add support for Ubuntu 24.04 LTS + Fedora 40	2024-05-31 23:30:45 +02:00
.gitignore	feat: Update supported platforms & CI	2024-12-29 11:36:36 +01:00
.releaserc.yml	feat: Update CI to latest standards	2022-10-09 23:48:42 +02:00
.roles	feat: Update CI to latest standards	2022-10-09 23:48:42 +02:00
.yamllint	feat: Update supported platforms & CI	2024-12-29 11:36:36 +01:00
CHANGELOG.md	chore(release): 1.8.0 [skip ci]	2025-08-06 22:03:06 +00:00
README.md	Update supported platforms & CI	2025-08-06 20:53:37 +02:00

README.md

ansible-role-opendkim

Install & manages OpenDKIM

Dependencies

Roles

None

Collections

community.crypto

Platforms

Supported platforms

Red Hat Enterprise Linux 8¹
Red Hat Enterprise Linux 9¹
Red Hat Enterprise Linux 10¹
RockyLinux 8
RockyLinux 9
RockyLinux 10
OracleLinux 8
OracleLinux 9
OracleLinux 10
AlmaLinux 8
AlmaLinux 9
AlmaLinux 10
Debian 11 (Bullseye)
Debian 12 (Bookworm)
Debian 13 (Trixie)
Ubuntu 20.04 LTS
Ubuntu 22.04 LTS
Ubuntu 24.04 LTS
Fedora 41
Fedora 42

Note: ¹ : no automated testing is performed on these platforms

Role Variables

defaults/main.yml


# OpenDKIM private key
opendkim_private_key: /etc/opendkim/keys/dkim.private.key

# OpenDKIM public key
opendkim_public_key: /etc/opendkim/keys/dkim.public.key

# List of domain
opendkim_domains: "{{ [opendkim_domain] }}"

# Private key bits
opendkim_key_bits: 1024

# OS user/group
opendkim_user: opendkim
opendkim_group: opendkim

# Default settings
opendkim_settings:
  Mode: sv
  Selector: key
  ReportAddress: '"{{ opendkim_domain }} postmaster" '
  KeyTable: '/etc/opendkim/KeyTable'
  SigningTable: 'refile:/etc/opendkim/SigningTable'
  ExternalIgnoreList: 'refile:/etc/opendkim/TrustedHosts'
  InternalHosts: 'refile:/etc/opendkim/TrustedHosts'
  Socket: 'inet:8891@localhost'

opendkim_postfix_settings:
  milter_default_action: accept
  milter_protocol: '6'
  smtpd_milters: 'inet:127.0.0.1:8891'
  non_smtpd_milters: $smtpd_milters

defaults/family-Debian.yml


opendkim_packages:
  - opendkim
  - opendkim-tools

defaults/family-RedHat-7.yml


opendkim_packages:
  - opendkim

defaults/family-RedHat.yml


opendkim_packages:
  - opendkim
  - opendkim-tools

defaults/family-Suse.yml


opendkim_packages:
  - opendkim
  - opendkim-tools

Example Playbook

molecule/default/converge.yml


- name: sample playbook for role 'opendkim'
  hosts: all
  become: 'yes'
  vars:
    postfix_ipv6: false
    postfix_domain: example.com
    postfix_fqdn: host.example.com
    postfix_ssl_key: '{{ openssl_server_key }}'
    postfix_ssl_chain: '{{ openssl_server_crt }}'
    opendkim_domain: example.com
  roles:
    - deitkrachten.cron
    - deitkrachten.openssl
    - deitkrachten.postfix
  tasks:
    - name: Include role 'opendkim'
      ansible.builtin.include_role:
        name: opendkim