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>