mailman: support ssl on mailman domains
[hcoop/domtool2.git] / lib / apache.dtl
... / ...
CommitLineData
1{{Apache web server configuration}}
2
3extern type web_node;
4{{Nodes that accept Apache configuration from you}}
5
6extern val web_node_to_node : web_node -> node;
7
8extern type web_place;
9extern val web_place_default : web_node -> web_place;
10extern val web_place : web_node -> your_ip -> your_ipv6 -> web_place;
11extern val web_place_to_web_node : web_place -> web_node;
12extern val web_place_to_node : web_place -> node;
13extern val web_place_to_ip : web_place -> ip;
14extern val web_place_to_ipv6 : web_place -> ipv6;
15{{Web places are combinations of web nodes (servers on which you are allowed to
16 run web sites) and IP addresses on which those servers should listen for
17 requests.}}
18
19context Vhost;
20{{A WWW virtual host}}
21
22extern type suexec_flag;
23{{Whether or not to use Suexec with a vhost.
24For users with the 'www' privilege, this type is identical to [bool].
25For others, it has only one value, [true].}}
26
27extern type ssl_cert_path;
28{{Filesystem path to an SSL certificate in your 'cert' list}}
29
30extern type ssl_cacert_path;
31{{Filesystem path to an intermediate CA certificate in your 'cacert' list}}
32
33extern type ssl;
34extern val no_ssl : ssl;
35extern val use_cert : ssl_cert_path -> ssl;
36
37extern type php_version;
38extern val php56 : php_version;
39{{FastCGI based php 5.6.}}
40extern val php72 : php_version;
41{{FastCGI based php 7.2.}}
42
43val fast_php : php_version = php56;
44
45extern val vhost : host -> Vhost => [Domain]
46 {WebPlaces : [web_place],
47 SSL : ssl,
48 User : your_user,
49 Group : your_group,
50 DocumentRoot : your_path,
51 ServerAdmin : email,
52 SuExec : suexec_flag,
53 PhpVersion : php_version};
54{{Add a new named Apache virtual host, specifying which nodes' Apache servers
55 should answer requests for this host, whether it should use SSL, what UNIX
56 user and group dynamic content generators should be run as, the filesystem
57 path to the static content root, and the e-mail address to which error pages
58 should direct visitors.}}
59
60extern val vhostDefault : Vhost => [Domain]
61 {WebPlaces : [web_place],
62 SSL : ssl,
63 User : your_user,
64 Group : your_group,
65 DocumentRoot : your_path,
66 ServerAdmin : email,
67 SuExec : suexec_flag,
68 PhpVersion : php_version};
69{{Like <tt>vhost</tt>, but for, e.g., <tt>yourdomain.com</tt> instead of
70 <tt>www.yourdomain.com</tt>}}
71
72context Location;
73
74extern type location;
75{{A valid URI prefix}}
76
77extern val location : location -> ^Vhost & Location => [Vhost & !Location];
78extern val directory : your_path -> ^Vhost & Location => [Vhost & !Location];
79{{Set some configuration specific to a URI prefix or filesystem directory,
80 respectively.}}
81
82extern type regexp;
83{{PCRE regular expression}}
84
85extern val filesMatch : regexp -> ^Vhost & Location => [Vhost & !Location];
86{{Mark nested configuration to only apply to filenames matching the regexp.}}
87
88extern val serverAliasHost : your_domain_host -> [Vhost];
89{{Give an alternate hostname for this vhost.}}
90extern val serverAlias : host -> [Vhost];
91{{Like serverAliasHost, but adds an alias for the given hostname at every domain
92 being configured.}}
93extern val serverAliasDefault : [Vhost];
94{{Like serverAliasDefault, but adds aliases for the domains being configured
95 instead of any of their hosts/"subdomains".}}
96
97extern val testNoHtaccess : [Location];
98
99extern val sslCertificateChainFile : ssl_cacert_path -> [Vhost];
100{{Intermediate file to serve as part of the chain of authority for
101 your ssl certificate}}