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.codeberg.page/weborf/

AUTHORS

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

Minimal webserver                                 May 09, 2024                                         Weborf(5)