Configuration Reference

From Sympl Wiki
Revision as of 13:42, 9 July 2019 by Kelduum (talk | contribs)
Jump to navigation Jump to search
This article is a Stub. You can help the Sympl Project by expanding it.

The configuration for Sympl is comprised of a number of text files in each domains config directory (i.e. /srv/example.com/config/) and the /etc/sympl directory, which covers system level configurations.

Domain config directory

File or Directory Used For Example content
.../config/dns/ This directory contains the automatically generated DNS files in TinyDNS format. n/a
.../config/ip 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. 10.11.12.13 2001:0db8:85a3:0000:0000:8a2e:0370:7334
.../config/spf 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. v=spf1 ip4:192.0.2.0/24 ip4:198.51.100.123 a -all
.../config/dkim Existence of this file will enable DKIM record generation and along with the dkim.key file 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.

signedmail
.../config/dkim.key This key is used to sign outgoing DKIM mails. Required to be able to sign mails, along with the dkim file. An RSA key beginning:

-----BEGIN RSA PRIVATE KEY-----

.../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. v=DMARC1; p=quarantine; sp=none:300
.../config/disable-php-security Existence of this file will disable some of the PHP security functions in the automatically generated Apache configurations. See PHP Security for more information. n/a
.../config/disable-filesystem-security Existence of this file will disable the automatic filesystem security tasks on this domain. See Filesystem Security for more information. n/a
.../config/stats This file enables automatic generation of web stats with Webalizer. A matching stats.htpasswd file will be needed to access them at example.com/stats. n/a
.../config/stats.htpasswd A htpasswd format file used to access the Web Statistics. Use the command htpasswd -c /srv/example.com/config/stats.htpasswd username to create one. stats:$apr1$IHaD0/..$N9ne/Bqnh8.MyOtvKU56j1

(This table is currently incomplete)