2016-06-28 23:53:10 +08:00
# Mongoose - Embedded Web Server / Embedded Networking Library
2012-08-26 05:48:14 +08:00
2020-12-05 19:46:12 +08:00
![License: GPLv2 ](https://img.shields.io/badge/license-GPL_2-green.svg "License" )
2020-12-18 19:32:59 +08:00
[![Build Status ]( https://github.com/cesanta/mongoose/workflows/build/badge.svg )](https://github.com/cesanta/mongoose/actions)
2020-12-07 16:08:21 +08:00
[![Code Coverage ](https://codecov.io/gh/cesanta/mongoose/branch/master/graph/badge.svg )](https://codecov.io/gh/cesanta/mongoose)
2021-01-06 02:10:01 +08:00
[![Fuzzing Status ](https://oss-fuzz-build-logs.storage.googleapis.com/badges/mongoose.svg )](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened& can=1& q=proj:mongoose)
2014-04-10 01:10:49 +08:00
2020-12-07 05:12:05 +08:00
Mongoose is a networking library for C/C++. It implements event-driven
non-blocking APIs for TCP, UDP, HTTP, WebSocket, MQTT. It has been designed
for connecting devices and bringing them online. On the market since 2004, used
by vast number of open source and commercial products - it even runs on the
International Space Station! Mongoose makes embedded network programming fast,
robust, and easy.
2014-04-10 01:10:49 +08:00
2017-07-17 20:10:24 +08:00
- [Download Mongoose Source Code here ](https://www.cesanta.com/download.html )
2020-12-10 22:21:38 +08:00
- [Read Mongoose documentation ](https://cesanta.com/docs/ )
2015-08-20 15:56:14 +08:00
2020-12-05 19:41:23 +08:00
Connectivity is vital for software and embedded devices, but there are many
pitfalls to consider when embedding a web server. This white paper breaks down
on the top 9 things to avoid when embedding a web server.
2020-06-25 00:08:35 +08:00
- [Download “9 Things NOT to do when embedding a web server” white paper here ](https://www.cesanta.com/whitepaper.html )
2020-12-05 19:41:23 +08:00
Looking for a complete IoT solution? Check out
- [VCON ](https://vcon.io ) - Arduino compatible MCU modules with built-in firmware OTA updates
2020-12-09 00:53:35 +08:00
- [Mongoose OS ](https://mongoose-os.com ) - open source embedded operating system for low-power connected microcontrollers. Secure, designed for commercial Internet of Things products
2016-10-18 19:35:47 +08:00
# Support
2020-12-10 22:21:38 +08:00
- [Study Mongoose examples ](https://github.com/cesanta/mongoose/tree/master/examples )
2020-12-05 19:41:23 +08:00
- [Support Forum - ask your technical questions here ](https://forum.cesanta.com/c/mongoose-library/6 )
2017-07-17 20:10:24 +08:00
- [Commercial licensing and support available ](https://www.cesanta.com/licensing.html )
2020-12-10 22:21:38 +08:00
- [Check out latest releases ](https://github.com/cesanta/mongoose/releases )
2013-01-02 07:05:09 +08:00
2015-09-08 19:49:03 +08:00
# Features
2015-12-22 15:46:05 +08:00
* Cross-platform: works on Linux/UNIX, MacOS, QNX, eCos, Windows, Android,
2020-12-05 19:41:23 +08:00
iPhone, FreeRTOS, etc
2020-12-30 01:59:05 +08:00
* Supported embedded architectures: ESP32, ESP8266, TI CC3200, TI MSP432, NRF52, STM32, PIC32, NXP, and more
* Builtin protocols: plain TCP/UDP, HTTP, MQTT, Websocket
* SSL/TLS support: mbedTLS, OpenSSL or custom via API
* Asynchronous DNS resolver
2015-09-08 19:49:03 +08:00
* 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-04 23:08:19 +08:00
# Licensing
2016-10-19 22:33:08 +08:00
Mongoose is released under Commercial and [GNU GPL v.2 ](http://www.gnu.org/licenses/old-licenses/gpl-2.0.html ) open source licenses.
2016-03-04 23:08:19 +08:00
2017-07-17 20:10:24 +08:00
Commercial Projects: [Contact us for commercial license. ](https://www.cesanta.com/contact.html )
2015-09-08 19:49:03 +08:00
2015-08-18 16:50:00 +08:00
# Dashboard Example
2014-03-12 00:59:17 +08:00
2015-09-21 22:16:16 +08: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:
2017-07-17 20:10:24 +08:00
![](http://www.cesanta.com/images/dashboard.png)
2014-03-12 00:59:17 +08:00
2017-07-17 20:10:24 +08:00
[Developing a new product? Contact us today to discuss how Mongoose can help. ](https://www.cesanta.com/contact.html )
2014-03-12 00:59:17 +08:00
2016-03-01 18:41:24 +08:00
# Contributions
2020-02-13 18:20:05 +08:00
Contributions are welcome! Please follow the guidelines below:
- Sign [Cesanta CLA ](https://cesanta.com/cla.html ) and send GitHub pull request
- When making pull requests, please make sure that it has only one commit,
and imlements/fixes only one piece of functionality
2016-03-01 18:41:24 +08:00
2016-10-19 22:33:08 +08:00
# Looking for a pre-compiled Mongoose web server Windows or Mac binary?
2017-07-17 20:10:24 +08:00
- [Download pre-compiled Mongoose web server binary. ](https://www.cesanta.com/binary.html )