civetweb/UserManual.md

Overview

Mongoose is small and easy to use web server. It is self-contained, and does not require any external software to run. Mongoose can be configured via command line options, or via configuration file, or it can be run with no configuration at all, thanks to the reasonable defaults. If no command line options are given, mongoose searches for a configuration file called "mongoose.conf" in the same directory where mongoose binary is located, and uses it if it is present.

Configuration file is a sequence of lines, each line containing command line option name and it's value. Empty lines, and lines beginning with #, are ignored. Here is the example of mongoose.conf file:

# mongoose.conf file
document_root c:\www
listening_ports 8080,8043s
ssl_certificate c:\mongoose\ssl_cert.pem

Usage Examples

• How to share a Windows folder. Copy mongoose executable to a folder and double-click the executable. The folder should be accessible via http://localhost:8080 in any browser.

Command Line Options

Common Problems

Embedding

Other Resources

• Presentation made by Arnout Vandecappelle at FOSDEM 2011 on 2011-02-06 in Brussels, Belgium, called "Creating secure web based user interfaces for Embedded Devices" (pdf | odp)
• Linux Journal article by Michel J.Hammel, 2010-04-01, called Mongoose: an Embeddable Web Server in C