Section: User Manuals (5)Updated: February 2003Local indexUp
NAME
nanoweb.conf - Nanoweb main configuration file
DESCRIPTION
The file
nanoweb.conf
is the main configuration file of the Nanoweb HyperText Transfer Protocol
server and contains all the general settings that must apply to all files
served from your host. It is usually located in the directory
/etc/nanoweb/.
Some parts of the configuration are seperated out of the main file, but this
man page anyhow only discusses a very small subset (the core directives) of
all possible settings. For further and uptodate information please refer to
the manual on
http://localhost/manual/
using your favorite browser.
FILE FORMAT
The configuration files are divided in sections whose names are given in
square brackets, we'll only discuss the main (which is the biggest) part
in this man page:
[global]
All other sections define virtual hosts. But see the file
vhosts.conf
for an example of what this means in practice.
In any section you can assing values to the
configuration directives
in this form:
directive =
value...
Starting from Nanoweb 1.8.1 you can leave out the equal sign.
CONFIGURATION DIRECTIVES
These are the core configuration directives that can be used in the
[global]
section (most of them can be used in virtual host sections, too).
You'll see some example settings for them in this man page.
Defines the default server name Nanoweb will respond to and with.
ServerAlias = *.example.com
Is an additional dns name glob the server will accept.
DocumentRoot = /var/www
Defines the base directory under which all files must be located in, if they
should be accessible via http.
DirectoryIndex = index.php index.html
If one of the files specified with this directive is found in a directory it
gets send in favour of a server generated directory listing.
ServerMode = standalone
This tells Nanoweb to run in standard mode, which is to work as standalone
server daemon. The other possible setting here is inetd.
DefaultContentType = text/plain
If a file type can not be automagically determined for a file, Nanoweb will
tell it's of the
mime(1)
type specified here.
Include = /etc/nanoweb/modules.conf
This directive loads another Nanoweb configuration file into the current one
and leads of course to processing of the directives specified therein.
MimeTypes = /etc/mime.types
Loads the given file which should contain all known file name extensions associated with
the according
mime(1)
types.
ParseExt = php CGI /usr/bin/php $SCRIPT_FILENAME
Associates a file extension with a parser, commonly a scripting language
interpreter like
perl(1)
or
php(1)
AccessFile = .htaccess
Files with the name given here may contain additonal directives that
apply to the directory (and subdirectories) they're located in.
ErrorDocument = 404 error404.php
Gives a custom error response file which gets send instead of one of the
builtin error messages, whenever one occours ("file not found" in this
example).
User = www-data
Sets the user id the Nanoweb daemon will run as. Normally you don't want
nanoweb to run with root privileges. Likewise for
Group.
Log = /var/log/nanoweb/access.log
The servers log file.
IgnoreDotFiles = 1
Do not deliver files whose name begins with a dot (usually referred to as
"hidden files").
AllowExtSymlinks = 1
Deliver files which are symlinked to outside of the DocumentRoot.
ListenInterface = 0.0.0.0
The network interface Nanoweb shall listen on. When set to 0.0.0.0 the
server will listen on all available network cards (lo, eth0 as well as
ppp0 on Linux boxes).
ListenPort = 80
The TCP port address the server should listen to. 80 is the default for
webservers, so you don't want to change this.
FILES
/etc/nanoweb/nanoweb.conf
The main configuration file, but following parts are seperated out of it in
the standard distribution:
/etc/nanoweb/modules.conf
This part of the main configuration loads the extension modules and
defines additional directives for them.
/etc/nanoweb/vhosts.conf
This part of the Nanoweb configuration defines the virtual hosts and
directives that only apply to them.