Propellor.Property.Apache

Documentation

installed :: Property NoInfo

restarted :: Property NoInfo

reloaded :: Property NoInfo

type ConfigLine = String

type ConfigFile = [ConfigLine]

siteEnabled :: Domain -> ConfigFile -> RevertableProperty NoInfo

siteEnabled' :: Domain -> ConfigFile -> Property NoInfo

siteDisabled :: Domain -> Property NoInfo

siteAvailable :: Domain -> ConfigFile -> Property NoInfo

modEnabled :: String -> RevertableProperty NoInfo

listenPorts :: [Port] -> Property NoInfo

Make apache listen on the specified ports.

Note that ports are also specified inside a site's config file, so that also needs to be changed.

siteCfg :: Domain -> [FilePath]

multiSSL :: Property NoInfo

Configure apache to use SNI to differentiate between https hosts.

This was off by default in apache 2.2.22. Newver versions enable it by default. This property uses the filename used by the old version.

allowAll :: ConfigLine

Config file fragment that can be inserted into a Directory stanza to allow global read access to the directory.

Works with multiple versions of apache that have different ways to do it.

iconDir :: ConfigLine

Config file fragment that can be inserted into a VirtualHost stanza to allow apache to display directory index icons.

type WebRoot = FilePath

virtualHost :: Domain -> Port -> WebRoot -> RevertableProperty NoInfo

A basic virtual host, publishing a directory, and logging to the combined apache log file. Not https capable.

virtualHost' :: Domain -> Port -> WebRoot -> [ConfigLine] -> RevertableProperty NoInfo

Like virtualHost but with additional config lines added.

httpsVirtualHost :: Domain -> WebRoot -> AgreeTOS -> RevertableProperty NoInfo

A virtual host using https, with the certificate obtained using letsEncrypt.

http connections are redirected to https.

Example:

httpsVirtualHost "example.com" "/var/www"
	(LetsEncrypt.AgreeTOS (Just "[e-mail]"))

Note that reverting this property does not remove the certificate from letsencrypt's cert store.

httpsVirtualHost' :: Domain -> WebRoot -> AgreeTOS -> [ConfigLine] -> RevertableProperty NoInfo

Like httpsVirtualHost but with additional config lines added.