2016-03-01 15:32:06 +02:00
|
|
|
# <img src="http://www.cesanta.com/hubfs/www.cesanta.com/Images/mongoose_library.png" width="64" height="64"> Mongoose - Embedded Web Server
|
2012-08-25 22:48:14 +01:00
|
|
|
|
2015-09-08 13:49:03 +02:00
|
|
|
![](https://img.shields.io/badge/license-GPL_2-green.svg "License")
|
2014-04-09 18:10:49 +01:00
|
|
|
|
2015-12-21 12:13:48 +01:00
|
|
|
Mongoose is ideal for embedded environments. It has been designed
|
|
|
|
for connecting devices and bringing them online.
|
2015-09-21 17:16:16 +03:00
|
|
|
[Mongoose](https://www.cesanta.com/products)
|
|
|
|
has been on the market since 2004 and attracted
|
|
|
|
over 1 million cumulative downloads.
|
|
|
|
|
2015-09-08 13:49:03 +02:00
|
|
|
It provides easy to use event-driven interface that allows to implement
|
|
|
|
network protocols or scalable network applications with little effort.
|
|
|
|
Mongoose helps developers to manage the complexity of network programming
|
|
|
|
and let them concentrate on the logic, saving time and money.
|
2014-04-09 18:10:49 +01:00
|
|
|
|
2015-12-21 12:13:48 +01:00
|
|
|
- [Download Mongoose Source Code here](http://hubs.ly/H01bWvx0)
|
2016-03-01 15:32:06 +02:00
|
|
|
- [Ask questions on support forum](http://forum.cesanta.com/index.php?p=/categories/mongoose)
|
2015-12-21 12:13:48 +01:00
|
|
|
- [Read User Guide and API reference](https://docs.cesanta.com/mongoose)
|
2016-02-19 11:55:42 +00:00
|
|
|
- [Study mongoose example code](https://github.com/cesanta/mongoose/tree/master/examples)
|
2015-08-20 08:56:14 +01:00
|
|
|
|
2015-09-21 17:16:16 +03:00
|
|
|
> Nothing overdone. Nothing less. So unbelievably easy to use.
|
2015-09-21 18:06:32 +03:00
|
|
|
> Just how good software should be! -- Pritin Tyagaraj, SAP
|
2015-09-21 17:16:16 +03:00
|
|
|
|
2013-01-01 23:05:09 +00:00
|
|
|
|
2015-09-08 13:49:03 +02:00
|
|
|
# Features
|
|
|
|
|
2015-12-22 09:46:05 +02:00
|
|
|
* Cross-platform: works on Linux/UNIX, MacOS, QNX, eCos, Windows, Android,
|
2015-12-22 09:40:55 +02:00
|
|
|
iPhone, FreeRTOS (TI CC3200, ESP8266), etc
|
2015-09-08 13:49:03 +02:00
|
|
|
* Single-threaded, asynchronous, non-blocking core with simple event-based API
|
2016-02-19 11:55:42 +00:00
|
|
|
* Native support for [PicoTCP embedded TCP/IP stack](http://www.picotcp.com),
|
2015-12-22 09:40:55 +02:00
|
|
|
[LWIP embedded TCP/IP stack](https://en.wikipedia.org/wiki/LwIP)
|
2015-09-08 13:49:03 +02:00
|
|
|
* Builtin protocols:
|
|
|
|
- plain TCP, plain UDP, SSL/TLS (over TCP, one-way or two-way)
|
|
|
|
- HTTP client, HTTP server
|
2016-03-01 15:32:06 +02:00
|
|
|
- Websocket client, Websocket server
|
2015-09-08 13:49:03 +02:00
|
|
|
- JSON-RPC client, JSON-RPC server
|
|
|
|
- MQTT client, MQTT broker
|
|
|
|
- CoAP client, CoAP server
|
|
|
|
- DNS client, DNS server, async DNS resolver
|
|
|
|
* Tiny static and run-time footprint
|
|
|
|
* Source code is both ISO C and ISO C++ compliant
|
|
|
|
* Very easy to integrate: just copy
|
|
|
|
[mongoose.c](https://raw.githubusercontent.com/cesanta/mongoose/master/mongoose.c) and
|
|
|
|
[mongoose.h](https://raw.githubusercontent.com/cesanta/mongoose/master/mongoose.h)
|
|
|
|
files to your build tree
|
2016-03-01 15:32:06 +02:00
|
|
|
* Extensively tested and production-ready, trusted by many blue chip businesses
|
2015-09-08 13:49:03 +02:00
|
|
|
|
2015-08-18 09:50:00 +01:00
|
|
|
# Dashboard Example
|
2014-03-11 16:59:17 +00:00
|
|
|
|
2015-09-21 17:16:16 +03:00
|
|
|
Mongoose is often used to implement device dashboards and real-time
|
|
|
|
data exchange over Websocket. Here is a dashboard example that illustrates
|
|
|
|
the functionality:
|
|
|
|
|
2015-08-18 09:50:00 +01:00
|
|
|
![](http://www.cesanta.com/hubfs/www.cesanta.com/diagrams/dash_mongoose_diagram.png)
|
2014-03-11 16:59:17 +00:00
|
|
|
|
2015-08-18 09:50:00 +01:00
|
|
|
[Developing a new product? Contact us today to discuss how Mongoose can help
|
|
|
|
](https://www.cesanta.com/contact)
|
2014-03-11 16:59:17 +00:00
|
|
|
|
2016-03-01 10:41:24 +00:00
|
|
|
# Contributions
|
|
|
|
|
2016-03-01 15:32:06 +02:00
|
|
|
People who have agreed to the
|
|
|
|
[Cesanta CLA](https://docs.cesanta.com/contributors_la.shtml)
|
|
|
|
can make contributions. Note that the CLA isn't a copyright
|
|
|
|
_assigment_ but rather a copyright _license_.
|
|
|
|
You retain the copyright on your contributions.
|
|
|
|
|
|
|
|
# Licensing
|
|
|
|
|
|
|
|
You are using Mongoose under
|
|
|
|
[GPLv2](http://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
|
|
|
|
and until you commercialize your
|
|
|
|
application, can continue to use Mongoose free of charge.
|
|
|
|
|
|
|
|
Once you commercialize your product, in order to comply with GPLv2
|
|
|
|
you need to either open the source code of your product fully or
|
|
|
|
alternatively purchase a commercial license.
|
|
|
|
We offer [three levels of commercial licensing](https://www.cesanta.com/products):
|
|
|
|
|
|
|
|
- Mongoose Lite: cross platform integration, SSL/TLS, HTTP support
|
|
|
|
- Mongoose: Mongoose Lite + HTTP CGI, HTTP SSI, HTTP Digest Auth,
|
|
|
|
WebSocket support
|
|
|
|
- Mongoose Premium: Mongoose + Plain TCP, UDP, JSON-RPC, MQTT, DNS,
|
|
|
|
CoAP support
|
|
|
|
|
|
|
|
|
|
|
|
[Enquire about commercial licensing here](https://www.cesanta.com/contact)
|
|
|
|
|
|
|
|
# Mongoose Binary
|
|
|
|
|
|
|
|
This is our easy to use web server for web developers (PHP, Ruby, Python, etc)
|
|
|
|
and web designers. Available in three editions to suit your needs: free, pro
|
|
|
|
(USD 5) and dev edition (from USD 8). To install, simply download, double-click
|
|
|
|
to start and run browser - that's all!
|
|
|
|
|
|
|
|
[Download Mongoose Binary here](https://www.cesanta.com/products#binary)
|
|
|
|
|
|
|
|
# Other products by Cesanta
|
|
|
|
|
|
|
|
- [Smart.js](https://github.com/cesanta/smart.js) -
|
|
|
|
Generic, hardware independent, full-stack IoT software platform
|
|
|
|
- [V7](https://github.com/cesanta/v7) - Embedded JavaScript engine
|
|
|
|
- [Frozen](https://github.com/cesanta/frozen) - JSON parser and generator
|
|
|
|
- [SLRE](https://github.com/cesanta/slre) - Super Light Regular Expression
|
|
|
|
library
|
2016-03-01 10:41:24 +00:00
|
|
|
|
2016-02-19 11:55:42 +00:00
|
|
|
[![Analytics](https://ga-beacon.appspot.com/UA-42732794-5/project-page)](https://github.com/cesanta/mongoose)
|