2008-02-14 13:20:26 +00:00
|
|
|
# This file defines the options that can be used both for the Apache
|
|
|
|
# main server configuration, and for the virtual hosts. (The latter
|
|
|
|
# has additional options that affect the web server as a whole, like
|
|
|
|
# the user/group to run under.)
|
|
|
|
|
2014-04-14 15:26:48 +01:00
|
|
|
{ forMainServer, lib }:
|
2013-10-29 13:03:39 +00:00
|
|
|
|
2014-04-14 15:26:48 +01:00
|
|
|
with lib;
|
2008-02-14 13:20:26 +00:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
{
|
2009-11-04 17:00:42 +00:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
hostName = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.str;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = "localhost";
|
2013-10-29 13:03:39 +00:00
|
|
|
description = "Canonical hostname for the server.";
|
2009-11-04 18:14:42 +00:00
|
|
|
};
|
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
serverAliases = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.listOf types.str;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = [];
|
|
|
|
example = ["www.example.org" "www.example.org:8080" "example.org"];
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
Additional names of virtual hosts served by this virtual host configuration.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
2009-11-04 18:14:42 +00:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
port = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.int;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = 0;
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2016-11-12 14:35:32 +00:00
|
|
|
Port for the server. Option will be removed, use <option>listen</option> instead.
|
|
|
|
'';
|
|
|
|
};
|
|
|
|
|
|
|
|
listen = mkOption {
|
|
|
|
type = types.listOf (types.submodule (
|
|
|
|
{
|
|
|
|
options = {
|
|
|
|
port = mkOption {
|
|
|
|
type = types.int;
|
|
|
|
description = "port to listen on";
|
|
|
|
};
|
|
|
|
ip = mkOption {
|
|
|
|
type = types.string;
|
|
|
|
default = "*";
|
|
|
|
description = "Ip to listen on. 0.0.0.0 for ipv4 only, * for all.";
|
|
|
|
};
|
|
|
|
};
|
|
|
|
} ));
|
|
|
|
description = ''
|
|
|
|
List of { /* ip: "*"; */ port = 80;} to listen on
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2016-11-12 14:35:32 +00:00
|
|
|
|
|
|
|
default = [];
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
2008-04-19 11:21:42 +01:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
enableSSL = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.bool;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = false;
|
2013-10-29 13:03:39 +00:00
|
|
|
description = "Whether to enable SSL (https) support.";
|
2008-02-14 13:20:26 +00:00
|
|
|
};
|
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
# Note: sslServerCert and sslServerKey can be left empty, but this
|
|
|
|
# only makes sense for virtual hosts (they will inherit from the
|
|
|
|
# main server).
|
2011-09-14 19:20:50 +01:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
sslServerCert = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.nullOr types.path;
|
|
|
|
default = null;
|
2009-11-06 16:23:25 +00:00
|
|
|
example = "/var/host.cert";
|
2013-10-29 13:03:39 +00:00
|
|
|
description = "Path to server SSL certificate.";
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
2009-11-04 17:00:42 +00:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
sslServerKey = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.path;
|
2009-11-06 16:23:25 +00:00
|
|
|
example = "/var/host.key";
|
2013-10-29 13:03:39 +00:00
|
|
|
description = "Path to server SSL certificate key.";
|
2009-11-04 17:00:42 +00:00
|
|
|
};
|
|
|
|
|
2015-03-27 12:11:30 +00:00
|
|
|
sslServerChain = mkOption {
|
2015-04-27 17:23:55 +01:00
|
|
|
type = types.nullOr types.path;
|
|
|
|
default = null;
|
2015-03-27 12:11:30 +00:00
|
|
|
example = "/var/ca.pem";
|
2015-04-13 14:42:01 +01:00
|
|
|
description = "Path to server SSL chain file.";
|
2015-03-27 12:11:30 +00:00
|
|
|
};
|
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
adminAddr = mkOption ({
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.nullOr types.str;
|
2009-11-06 16:23:25 +00:00
|
|
|
example = "admin@example.org";
|
2013-10-29 13:03:39 +00:00
|
|
|
description = "E-mail address of the server administrator.";
|
|
|
|
} // (if forMainServer then {} else {default = null;}));
|
2009-11-06 16:23:25 +00:00
|
|
|
|
|
|
|
documentRoot = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.nullOr types.path;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = null;
|
|
|
|
example = "/data/webserver/docs";
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
The path of Apache's document root directory. If left undefined,
|
|
|
|
an empty directory in the Nix store will be used as root.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
2009-11-04 17:00:42 +00:00
|
|
|
|
2009-11-06 16:23:25 +00:00
|
|
|
servedDirs = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.listOf types.attrs;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = [];
|
|
|
|
example = [
|
|
|
|
{ urlPath = "/nix";
|
|
|
|
dir = "/home/eelco/Dev/nix-homepage";
|
|
|
|
}
|
|
|
|
];
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
This option provides a simple way to serve static directories.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
servedFiles = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.listOf types.attrs;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = [];
|
|
|
|
example = [
|
|
|
|
{ urlPath = "/foo/bar.png";
|
2015-04-28 08:39:35 +01:00
|
|
|
files = "/home/eelco/some-file.png";
|
2009-11-06 16:23:25 +00:00
|
|
|
}
|
|
|
|
];
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
This option provides a simple way to serve individual, static files.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-04 17:00:42 +00:00
|
|
|
};
|
2009-11-06 16:23:25 +00:00
|
|
|
|
|
|
|
extraConfig = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.lines;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = "";
|
|
|
|
example = ''
|
|
|
|
<Directory /home>
|
|
|
|
Options FollowSymlinks
|
|
|
|
AllowOverride All
|
|
|
|
</Directory>
|
|
|
|
'';
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
These lines go to httpd.conf verbatim. They will go after
|
|
|
|
directories and directory aliases defined by default.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
extraSubservices = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.listOf types.unspecified;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = [];
|
2013-10-29 13:03:39 +00:00
|
|
|
description = "Extra subservices to enable in the webserver.";
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
enableUserDir = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.bool;
|
2009-11-06 16:23:25 +00:00
|
|
|
default = false;
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
Whether to enable serving <filename>~/public_html</filename> as
|
|
|
|
<literal>/~<replaceable>username</replaceable></literal>.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
globalRedirect = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.nullOr types.str;
|
|
|
|
default = null;
|
2009-11-06 16:23:25 +00:00
|
|
|
example = http://newserver.example.org/;
|
2013-10-29 13:03:39 +00:00
|
|
|
description = ''
|
2009-11-06 16:23:25 +00:00
|
|
|
If set, all requests for this host are redirected permanently to
|
|
|
|
the given URL.
|
2013-10-29 13:03:39 +00:00
|
|
|
'';
|
2009-11-06 16:23:25 +00:00
|
|
|
};
|
|
|
|
|
2012-05-12 00:14:05 +01:00
|
|
|
logFormat = mkOption {
|
2013-10-29 13:03:39 +00:00
|
|
|
type = types.str;
|
2012-05-12 00:14:05 +01:00
|
|
|
default = "common";
|
|
|
|
example = "combined";
|
2014-09-18 18:04:59 +01:00
|
|
|
description = ''
|
2012-05-12 00:14:05 +01:00
|
|
|
Log format for Apache's log files. Possible values are: combined, common, referer, agent.
|
2014-09-18 18:04:59 +01:00
|
|
|
'';
|
|
|
|
};
|
|
|
|
|
|
|
|
robotsEntries = mkOption {
|
|
|
|
type = types.lines;
|
|
|
|
default = "";
|
|
|
|
example = "Disallow: /foo/";
|
|
|
|
description = ''
|
|
|
|
Specification of pages to be ignored by web crawlers. See <link
|
|
|
|
xlink:href='http://www.robotstxt.org/'/> for details.
|
|
|
|
'';
|
2012-05-12 00:14:05 +01:00
|
|
|
};
|
|
|
|
|
2009-11-04 17:00:53 +00:00
|
|
|
}
|