Linux Certif

Toute la documentation sur la certification Linux LPI

nanoweb.conf

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/