The Server core configuration resides in the file monkey.conf, which is the primary and mandatory configuration file for Monkey HTTP Server. It contains many keys that can alter the server behavior, all of them are associated under the SERVER section. Below a description on each one found on this Monkey version.
Port represents the number of the TCP door on which Monkey will be listening for incoming connections and HTTP requests. This number can have any value between 1 and 65535. Just note that for TCP ports under 1024 requires root priviledges.
By default Monkey comes configured to use TCP port 2001, this number represents when the Project was born, but of course any available TCP port can be used.
On Linux as on any Unix OS, can exists many network interfaces that may represent physical or virtual Ethernet devices. The Listen key specify where the Server should listen for incoming connections. It must be assiged to an IPv4 or IPv6 address. By default the Server listen on all interfaces on IPv4 mode which is represented by 0.0.0.0.
As an example, to restrict only connections coming from localhost which is represented by the IPv4 address 127.0.0.1, the configuration should look as follows:
In the other hand, to restrict to localhost connections but in IPv6 mode you should use:
By default this key is commented on the configuration.
Monkey architecture is designed to work in asyncronous mode and in order to scale on SMP systems, it allows to spawn a fixed number of threads called Workers. Each worker is capable to handle thousands of connections if the system allows that.
The Workers key defines the number of Workers to spawn when Monkey starts. By default this key comes with value 0 which aims to spawn one worker per existent CPU core.
The Timeout key, represents the largest span of time expressed in seconds, during which a connected client should issue a complete request. The Timeout value must be > 0. By default is 15 seconds.
The PidFile key specifies where the Server stores the process identificator when starting up.
Monkey is capable to serve public system users directories, they are accessed through the URI prefix /~username. The UserDir key specifies the public directory name that must be located on each user home directory.
When an incoming HTTP request arrives and it's mapped to a file system directory, the Server needs to know which file serve by default. The IndexFile key allows to define multiple files that are looked up in order, the values must be file names, not relative or absolute paths.
Indexfile index.html index.htm index.php
For security reasons users may want to hide the specific Server version, enabling this flag will turn the version to be hided when sending HTTP responses. The key accepts boolean values on and off. By default this value is off.
When serving static files, a client may want to request a range of bytes instead of a complete file. The Resume key turns this feature enabled or disabled in the Server. The key accepts boolean values on and off. By default this value is on.
The server can run as a different user at process level. To accomplish this the User key allows to define the user that the running process will change to. This will only happen if the original user have root priviledges. If this Key is commented out, no user change will be done.
The following configuration keys aims to be used by advanced users, just use them on specific cases where is really needed.
It allows to enable or disable the HTTP KeepAlive feature. The key accepts boolean values on and off. By default this value is on.
On a HTTP KeepAlive session, specify the number of seconds to wait for the next incoming request, once the KeepAliveTimeout value is reached the connection is closed. The value must be > 0. By default this value is 5.
Under a HTTP KeepAlive session, set the maximum number of HTTP requests allowed. This value must be > 0. By default this value is 1000.
When a HTTP request arrives, Monkey allocates a fixed memory buffer. If the incoming request data is larger than the original buffer size, it will allocate more space as needed. The MaxRequestSize key defines the maximum number of KiloBytes than a buffer can grow. Example: defining MaxRequestSize 32 means 32 Kilobytes. The value defined must be greater than zero. Default value defined is 32.
A HTTP request may target a file which is in reallity a symbolic link in the file system. The SymLink key defines if the server may serve or not the linked target file. The key accepts boolean values on and off. By default this value is off.
Monkey core needs to know which Plugin handle the transport layer. The value specified for this key belongs to the shortname of the Plugin. The available options are:
The default value is liana.
The TransportLayer plugin must be loaded on plugins.load configuration file.
When a static file is requested and it does not contain a known extension based on the mime types registered on monkey.mime configuration file, Monkey will send the mime type specified on this key.
The File Descriptor Table (FDT) it's an internal mechanism to share open file descriptors under specific threads and virtual host context. When enabled, it helps to reduce the number of opened file descriptors for the same resource and the number of required system calls to open and close files.
The overhead in memory of this feature is around ~5KB per worker. The key accepts boolean values on and off. By default this value is on.