1 # Boa v0.94 configuration file
2 # Customized for Debian GNU/Linux by Jonathon Nelson <jnelson@boa.org>
3 # File format has not changed from 0.93
4 # File format has changed little from 0.92
5 # version changes are noted in the comments
7 # The Boa configuration file is parsed with a lex/yacc or flex/bison
8 # generated parser. If it reports an error, the line number will be
9 # provided; it should be easy to spot. The syntax of each of these
10 # rules is very simple, and they can occur in any order. Where possible
11 # these directives mimic those of NCSA httpd 1.3; I saw no reason to
12 # introduce gratuitous differences.
14 # $Id: boa.conf,v 1.7 2001/09/25 03:28:30 jnelson Exp $
16 # The "ServerRoot" is not in this configuration file. It can be compiled
17 # into the server (see defines.h) or specified on the command line with
18 # the -c option, for example:
20 # boa -c /usr/local/boa
23 # Port: The port Boa runs on. The default port for http servers is 80.
24 # If it is less than 1024, the server must be started as root.
28 # PidFile: The file that boa should write it's PID to
29 # NOT FUNCTIONAL YET -- just a stub for now
30 #PidFile /var/run/boa.pid
32 # Listen: the Internet address to bind(2) to. If you leave it out,
33 # it takes the behavior before 0.93.17.2, which is to bind to all
34 # addresses (INADDR_ANY). You only get one "Listen" directive,
35 # if you want service on multiple IP addresses, you have three choices:
36 # 1. Run boa without a "Listen" directive
37 # a. All addresses are treated the same; makes sense if the addresses
38 # are localhost, ppp, and eth0.
39 # b. Use the VirtualHost directive below to point requests to different
40 # files. Should be good for a very large number of addresses (web
42 # 2. Run one copy of boa per IP address, each has its own configuration
43 # with a "Listen" directive. No big deal up to a few tens of addresses.
44 # Nice separation between clients.
45 # The name you provide gets run through inet_aton(3), so you have to use dotted
46 # quad notation. This configuration is too important to trust some DNS.
50 # User: The name or UID the server should run as.
51 # Group: The group name or GID the server should run as.
56 # ServerAdmin: The email address where server problems should be sent.
57 # Note: this is not currently used, except as an environment variable
60 #ServerAdmin root@localhost
62 # ErrorLog: The location of the error log file. If this does not start
63 # with /, it is considered relative to the server root.
64 # Set to /dev/null if you don't want errors logged.
65 # If unset, defaults to /dev/stderr
67 ErrorLog /var/log/boa/error_log
68 # Please NOTE: Sending the logs to a pipe ('|'), as shown below,
69 # is somewhat experimental and might fail under heavy load.
70 # "Usual libc implementations of printf will stall the whole
71 # process if the receiving end of a pipe stops reading."
72 #ErrorLog "|/usr/sbin/cronolog --symlink=/var/log/boa/error_log /var/log/boa/error-%Y%m%d.log"
74 # AccessLog: The location of the access log file. If this does not
75 # start with /, it is considered relative to the server root.
76 # Comment out or set to /dev/null (less effective) to disable
79 AccessLog /var/log/boa/access_log
80 # Please NOTE: Sending the logs to a pipe ('|'), as shown below,
81 # is somewhat experimental and might fail under heavy load.
82 # "Usual libc implementations of printf will stall the whole
83 # process if the receiving end of a pipe stops reading."
84 #AccessLog "|/usr/sbin/cronolog --symlink=/var/log/boa/access_log /var/log/boa/access-%Y%m%d.log"
86 # UseLocaltime: Logical switch. Uncomment to use localtime
90 # VerboseCGILogs: this is just a logical switch.
91 # It simply notes the start and stop times of cgis in the error log
92 # Comment out to disable.
96 # ServerName: the name of this server that should be sent back to
97 # clients if different than that returned by gethostname + gethostbyname
99 #ServerName www.your.org.here
101 # VirtualHost: a logical switch.
102 # Comment out to disable.
103 # Given DocumentRoot /var/www, requests on interface 'A' or IP 'IP-A'
104 # become /var/www/IP-A.
105 # Example: http://localhost/ becomes /var/www/127.0.0.1
107 # Not used until version 0.93.17.2. This "feature" also breaks commonlog
108 # output rules, it prepends the interface number to each access_log line.
109 # You are expected to fix that problem with a postprocessing script.
113 # DocumentRoot: The root directory of the HTML documents.
114 # Comment out to disable server non user files.
116 DocumentRoot /var/www
118 # UserDir: The name of the directory which is appended onto a user's home
119 # directory if a ~user request is recieved.
123 # DirectoryIndex: Name of the file to use as a pre-written HTML
124 # directory index. Please MAKE AND USE THESE FILES. On the
125 # fly creation of directory indexes can be _slow_.
126 # Comment out to always use DirectoryMaker
128 DirectoryIndex index.html
130 # DirectoryMaker: Name of program used to create a directory listing.
131 # Comment out to disable directory listings. If both this and
132 # DirectoryIndex are commented out, accessing a directory will give
133 # an error (though accessing files in the directory are still ok).
135 DirectoryMaker /usr/lib/boa/boa_indexer
137 # DirectoryCache: If DirectoryIndex doesn't exist, and DirectoryMaker
138 # has been commented out, the the on-the-fly indexing of Boa can be used
139 # to generate indexes of directories. Be warned that the output is
140 # extremely minimal and can cause delays when slow disks are used.
141 # Note: The DirectoryCache must be writable by the same user/group that
144 # DirectoryCache /var/spool/boa/dircache
146 # KeepAliveMax: Number of KeepAlive requests to allow per connection
147 # Comment out, or set to 0 to disable keepalive processing
151 # KeepAliveTimeout: seconds to wait before keepalive connection times out
155 # MimeTypes: This is the file that is used to generate mime type pairs
156 # and Content-Type fields for boa.
157 # Set to /dev/null if you do not want to load a mime types file.
158 # Do *not* comment out (better use AddType!)
160 MimeTypes /etc/mime.types
162 # DefaultType: MIME type used if the file extension is unknown, or there
163 # is no file extension.
165 DefaultType text/plain
167 # AddType: adds types without editing mime.types
168 # Example: AddType type extension [extension ...]
170 # Uncomment the next line if you want .cgi files to execute from anywhere
171 #AddType application/x-httpd-cgi cgi
173 # Redirect, Alias, and ScriptAlias all have the same semantics -- they
174 # match the beginning of a request and take appropriate action. Use
175 # Redirect for other servers, Alias for the same server, and ScriptAlias
176 # to enable directories for script execution.
178 # Redirect allows you to tell clients about documents which used to exist in
179 # your server's namespace, but do not anymore. This allows you to tell the
180 # clients where to look for the relocated document.
181 # Example: Redirect /bar http://elsewhere/feh/bar
183 # Aliases: Aliases one path to another.
184 # Example: Alias /path1/bar /path2/foo
186 Alias /doc /usr/share/doc
188 # ScriptAlias: Maps a virtual path to a directory for serving scripts
189 # Example: ScriptAlias /htbin/ /www/htbin/
191 ScriptAlias /cgi-bin/ /usr/lib/cgi-bin/
192 ScriptAlias /cgi-lib/ /usr/lib/cgi-bin/