dataset/seed/dovecot/README.md
2023-08-15 19:11:07 +02:00

7.8 KiB
Raw Blame History

Table of Contents

Return to the list of application services.

dovecot

Synopsis

Postfix and Dovecot as mail servers (Submission and IMAP).

Basic variables

Général

Mail configuration

Configure IMAP servers and submission to access email accounts and send emails.

Mail domain

This family is a leadership.

Parameter Comments
general.mail.domain.mail_domains
mandatory, multiple
Type: domainname
Final destination email address.
Example: example.net
general.mail.domain.imap_domainname
mandatory
Type: domainname
External IMAP server address.
Matches TLS connection's SNI name, if its sent by the client.
Example: imap.example.net
general.mail.domain.submission_domainname
mandatory
Type: domainname
External submission server address.
Matches TLS connection's SNI name, if its sent by the client.
Example: submission.example.net
Parameter Comments
general.mail.mail_crt_provider
mandatory
Type: choice
Type of certificate autority signing external IMAP and submission domain certificates.
The certificate can be self-signed (therefore invalid by default for the client) or obtained via the Let's Encrypt service (generally valid for the client).
Choices:
- self-signed ← default
- letsencrypt

Variables for expert

Général

Annuaire OpenLDAP

Client
Parameter Comments
general.ldap.client.ldapclient_family
mandatory
Type: unix_user
Nom de la famille LDAP.
Default: all
general.ldap.client.ldapclient_base_dn
mandatory
Type: string
Base DN de l'annuaire.
Default: calculated
general.ldap.client.ldapclient_search_dn
mandatory
Type: string
Base DN de l'annuaire des utilisateurs.
Default: calculated
general.ldap.client.ldapclient_group_dn
mandatory
Type: string
Base DN de l'annuaire des groupes.
Default: calculated
general.ldap.client.ldapclient_user_dn
mandatory
Type: string
Base DN de l'annuaire des utilisateurs n'appartenant à une famille.
Default: calculated

Requirements services

Mandatories

Optionals

bold: provider is mandatory

Example

Zone names are provided as examples. Think about adapting with the value of provider_zone in configuration file.

dovecot:
  applicationservice: dovecot
  provider_zone: imap
  zones_name:
    - ldap
    - localdns
    - oauth2
    - reverseproxy
    - smtp
  values:
    general.mail.domain.mail_domains:
      - example.net
    general.mail.domain.imap_domainname:
      '0': imap.example.net
    general.mail.domain.submission_domainname:
      '0': submission.example.net

Dependances

Useful for service

roundcube