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>