NAME

ahttpd.conf - main configuration file for ahttpd.

FORMAT

Each line is either a comment or a directive. Comment lines start with a # and are ignored. A directive line has the format:

option value

Option name is case sensitive.

OPTIONS

server-listen

IP address where server should listen for incoming connections. Value * means listening to all available interfaces.

Default value is *

server-port

TCP port to bind to.

Default value is 8080

server-user

Unprivileged user account for server to run as.

Standard value is _ahttpd

server-group

Unpriviledged group account for server to run as.

Standard value is _ahttpd

server-pidfile

File where server saves its PID. ahttpd uses this file to determine if another copy is running.

Standard path is /var/run/ahttpd.pid

server-host

Sometimes server creates a redirect response pointing to itself. There is no way for server to determine its externally known name. Every properly implemented HTTP/1.1 client should send this name as a part of request but it's very useful to have such a fallback.

Default value is localhost

server-acl

server supports a simple url based access control. This refers to a configuration file for that.

Default value is /etc/ahttpd/acl.conf

server-auth

All clients must be authenticated. Possible values of this parameter are none when authentication is turned off entirely, and session for session based authentication. Please note that in local mode server always turns off authentication. In this mode all users will be authenticated as user 'root'.

Default value is session

log-file

Access log file. Server uses this file to write access results for incoming connections.

Default path is /var/log/ahttpd/access.log

log-mode

Logging verbosity. Possible values are none (turned off), errors (errors only), and all (log everything).

Standard value is errors, default value is none.

tls-key-file

File with server's private SSL key. Server needs this file for HTTPS protocol.

Default path is /var/lib/ssl/private/ahttpd.key

tls-cert-file

File with server's public SSL certificate. Server needs this file for HTTPS protocol.

Standard path is /var/lib/ssl/certs/ahttpd.cert

framework-uri

Server forms every page as two parts: module part and framework part. Framework part is a common part, e.g., menu.

Standard path for System management center framework is /acc

login-uri

Path to login page definition.

Standard path for login page is /login

logout-uri

Path to logout page definition.

Standard path for logout page is /logout

AUTHOR

Stanislav Ievlev <inger@altlinux.org>

SEE ALSO

ahttpd(8), ahttpd.acl.conf(8)