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.

       ServerName = www.example.com
            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.

SEE ALSO

       nanoweb.php(8) http://localhost/manual/