Mail Configuration Reference: Difference between revisions

From Sympl Wiki
Jump to navigation Jump to search
No edit summary
Tag: 2017 source edit
No edit summary
Line 1: Line 1:


===Domain config directory===
==Configuration Reference==
<section begin=config />
<section begin=config />
{| class="wikitable sortable"
{| class="wikitable sortable"
Line 6: Line 6:
!File or Directory
!File or Directory
!Used For
!Used For
!Example content
|-
|-
|<code>.../config/dns/</code>
|<code>.../config/ip</code>
|This directory contains the automatically generated DNS files in [[TinyDNS Format|TinyDNS format]].
|Contains a list of IP addresses which mail will be sent from for the domain. Defaults to the primary IPs (IPv4 and IPv6) of your server.
|n/a
|-
|-
|<code>.../config/ip</code>
| colspan="2" |
|Contains a list of IP addresses which a website will be bound to, and mail will be sent from. If not set, defaults to the primary IPs (IPv4 and IPv6) of your server.
|<code>10.11.12.13 2001:0db8:85a3:0000:0000:8a2e:0370:7334</code>
|-
|-
|<code>.../config/spf</code>
|<code>.../config/spf</code>
|Existence of this file will add [[SPF Records]] to the automatically generated DNS files. If the file has content, that will be used as the SPF record.
|Existence of this file will add [[SPF Records]] to the automatically generated DNS files. Any content will be used as the SPF record.
|<code>v=spf1 ip4:192.0.2.0/24 ip4:198.51.100.123 a -all</code>
|-
|-
|<code>.../config/dkim</code>
|<code>.../config/dkim</code>
|Existence of this file will enable [[DKIM]] record generation and along with the <code>dkim.key</code> file will enable signing of outgoing mails.
|Enables [[DKIM]] record generation and along with <code>dkim.key</code>, will enable signing of outgoing mails. The DKIM 'selector' defaults to the short hostname of your server, otherwise any content in this file will be used as the selector in outgoing mails and automatically generated DNS.
The DKIM 'selector' defaults to the short hostname of your server, otherwise any content in this file will be used as the selector in outgoing mails and automatically generated DNS.
|<code>signedmail</code>
|-
|-
|<code>.../config/dkim.key</code>
|<code>.../config/dkim.key</code>
|This key is used to sign outgoing [[DKIM]] mails. Required to be able to sign mails, along with the <code>dkim</code> file.
|This key is used to sign outgoing [[DKIM]] mails. Required to be able to sign mails, along with the <code>dkim</code> file.
|An RSA key beginning:
<code>-----BEGIN RSA PRIVATE KEY-----</code>
|-
|-
|<code>.../config/dmarc</code>
|<code>.../config/dmarc</code>
|This file will create a [[DMARC]] record in generated DNS files. If the file is not empty, the content will be used as the new DMARC record.
|This file will create a [[DMARC]] record in generated DNS files. If the file is not empty, the content will be used as the new DMARC record.
|<code>v=DMARC1; p=quarantine; sp=none:300</code>
|-
|}<br />
| colspan="2" |
|}
See also [[Configuration Reference|''Configuration Reference'']] for other configuration files.<br />
 
<section end=config />
<section end=config />
[[Category:Reference]]
[[Category:Reference]]
[[Category:Mail]]
[[Category:Mail]]

Revision as of 09:24, 15 July 2019

Configuration Reference

File or Directory Used For
.../config/ip Contains a list of IP addresses which mail will be sent from for the domain. Defaults to the primary IPs (IPv4 and IPv6) of your server.
.../config/spf Existence of this file will add SPF Records to the automatically generated DNS files. Any content will be used as the SPF record.
.../config/dkim Enables DKIM record generation and along with dkim.key, will enable signing of outgoing mails. The DKIM 'selector' defaults to the short hostname of your server, otherwise any content in this file will be used as the selector in outgoing mails and automatically generated DNS.
.../config/dkim.key This key is used to sign outgoing DKIM mails. Required to be able to sign mails, along with the dkim file.
.../config/dmarc This file will create a DMARC record in generated DNS files. If the file is not empty, the content will be used as the new DMARC record.

See also Configuration Reference for other configuration files.