NAME

       weborf.conf - configuration file for weborf daemon

SYNOPSIS

       /etc/weborf.conf
       /etc/weborf.d/*.conf

DESCRIPTION

       Weborf is a minimal webserver. Also has a limited support for webdav.
       Can  be  started  as  stand-alone or as system daemon. This manual page documents Weborf's
       configuration file, used only when it is started as daemon.

DESCRIPTION

       Options are case sensitive. Immediately followed by the equal = sign,  without  any  space
       between name and value.  Lines beginning with # will be ignored and treated as comments.

       When  systemd  is  in use, every .conf file in /etc/weborf.d/ is used to start a different
       instance of weborf, with a different configuration. Otherwise the file /etc/weborf.conf is
       used to start a single instance of weborf.

       indexes
              By  default  weborf  searches  for  index.html.  Anyway it is possible to specify a
              different index file and also many index files. Name of the pages must be separated
              by a comma and between them there aren't spaces.

       basedir
              Default  base  directory used by the webserver. The default means that this will be
              used also when virtual hosts are enabled, if the  requested  host  is  unknown.  Of
              course the user used for the webserver will need to have access to this directory.

       use-cgi
              Can  be  true  or  false.  If  false  weborf will handle all files as normal files.
              Otherwise it will use the CGI protocol to execute some files.  Defaults to false.

       use-mime
              Can be true or false. If true weborf will  send  the  Content-Type  header  to  the
              clients.  Turning it off will increase speed but might cause problems with some old
              clients.

       cgi    List of extensions to consider as dynamic pages and binaries to  execute  them.  It
              takes  a  file  format  and  a path, comma separated, and the list can include more
              formats and paths. Eg: cgi=.php,/bin/phpexecutor,.sh,/bin/shellexecutor

       auth-socket
              Path of the unix socket that weborf will  use  to  connect  to  the  authentication
              server.  When  this is enabled, for every HTTP request weborf opens a connection to
              this socket, forwards the request, and the authentication daemon is  in  charge  of
              deciding  whether  to  accept  or  deny  the  request.  Examples  are  provided  in
              /usr/share/doc/weborf/examples.

       cachedir
              Will set the path of the directory used for caching. When this is  enabled,  weborf
              will cache PROPFIND and directory listing requests, making them faster.

       user   Username  of  the  user that will run the webserver. On Debian this is usually www-
              data.

       group  Groupname of the group that will run the webserver. On Debian this is usually  www-
              data.

       port   The port to use.

       key    Absolute path to the SSL key file. It must be used with the cert option.
              When set, weborf will use HTTPS instead of HTTP.

       cert   Absolute path to the SSL certificate file. It must be used with the key option.
              When set, weborf will use HTTPS instead of HTTP.

       virtual
              This    directive    is    used   to   enable   virtualhosts.    The   format   is:
              virtual=localhost=/var/www/,serverq.com=/var/www-alt/
              To run on multiple ports, more instances are needed.

       start  If this is  set  to  auto,  when  systemd  is  in  use,  the  instance  using  this
              configuration  file is considered as part of the weborf service and started/stopped
              along with it. It does nothing with other init systems.

SEE ALSO

       weborf(1)

WEB

       https://ltworf.github.io/weborf/

AUTHORS

       Salvo "LtWorf" Tomaselli <tiposchi@tiscali.it>
       Salvo Rinaldi <salvin@anche.no>