nixpkgs/modules/services/web-servers/apache-httpd/per-server-options.nix

# 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.)

{forMainServer, mkOption}:

{

  hostName = mkOption {
    default = "localhost";
    description = "
      Canonical hostname for the server.
    ";
  };

  serverAliases = mkOption {
    default = [];
    example = ["www.example.org" "www.example.org:8080" "example.org"];
    description = "
      Additional names of virtual hosts served by this virtual host configuration.
    ";
  };

  port = mkOption {
    default = 0;
    description = "
      Port for the server.  0 means use the default port: 80 for http
      and 443 for https (i.e. when enableSSL is set).
    ";
  };

  enableSSL = mkOption {
    default = false;
    description = "
      Whether to enable SSL (https) support.
    ";
  };

  # Note: sslServerCert and sslServerKey can be left empty, but this
  # only makes sense for virtual hosts (they will inherit from the
  # main server).
  
  sslServerCert = mkOption {
    default = ""; 
    example = "/var/host.cert";
    description = "
      Path to server SSL certificate.
    ";
  };

  sslServerKey = mkOption {
    default = "";
    example = "/var/host.key";
    description = "
      Path to server SSL certificate key.
    ";
  };

  adminAddr = mkOption ({
    example = "admin@example.org";
    description = "
      E-mail address of the server administrator.
    ";
  } // (if forMainServer then {} else {default = "";}));

  documentRoot = mkOption {
    default = null;
    example = "/data/webserver/docs";
    description = "
      The path of Apache's document root directory.  If left undefined,
      an empty directory in the Nix store will be used as root.
    ";
  };

  servedDirs = mkOption {
    default = [];
    example = [
      { urlPath = "/nix";
        dir = "/home/eelco/Dev/nix-homepage";
      }
    ];
    description = "
      This option provides a simple way to serve static directories.
    ";
  };

  servedFiles = mkOption {
    default = [];
    example = [
      { urlPath = "/foo/bar.png";
        dir = "/home/eelco/some-file.png";
      }
    ];
    description = "
      This option provides a simple way to serve individual, static files.
    ";
  };

  extraConfig = mkOption {
    default = "";
    example = ''
      <Directory /home>
        Options FollowSymlinks
        AllowOverride All
      </Directory>
    '';
    description = "
      These lines go to httpd.conf verbatim. They will go after
      directories and directory aliases defined by default.
    ";
  };

  extraSubservices = mkOption {
    default = [];
    description = "
      Extra subservices to enable in the webserver.
    ";
  };

  enableUserDir = mkOption {
    default = false;
    description = "
      Whether to enable serving <filename>~/public_html</filename> as
      <literal>/~<replaceable>username</replaceable></literal>.
    ";
  };

  globalRedirect = mkOption {
    default = "";
    example = http://newserver.example.org/;
    description = "
      If set, all requests for this host are redirected permanently to
      the given URL.
    ";
  };

}