Weborf(5)

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>