MCPcopy Create free account
hub / github.com/cesanta/mongoose

github.com/cesanta/mongoose

Chat with this repo
repository ↗ · DeepWiki ↗ · release 7.24 ↗ · + Follow · compare 3 versions
20,956 symbols 43,392 edges 928 files ⚖ custom 10,831 documented · 52% ● updated 47d ago7.23 · 2026-08-12★ 13,0712 open issues

Browse by type

⨍ Functions 18,146◇ Types & classes 2,810
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Mongoose: a full-stack embedded networking library

License: GPLv2/Commercial Build Status Code Coverage Fuzzing Status

Mongoose is a full-stack embedded networking library for C and C++. It includes a TCP/IP stack with drivers, TLS 1.3, an embedded web server with HTTP and WebSocket support, MQTT, and firmware OTA updates. All in just two files: mongoose.c and mongoose.h. Mongoose runs on STM32, NXP and other microcontrollers, on bare metal or with an RTOS, with no external dependencies. Ideal for cloud connectivity, device web dashboards, secure firmware updates and remote control.

Use it instead of lwIP + mbedTLS + httpd + an MQTT client + OTA glue code, or run it on top of lwIP or Zephyr.

On the market since 2004, used by a vast number of open source and commercial products - it even runs on the International Space Station! Features include:

  • Cross-platform:
  • works on Linux/UNIX, MacOS, Windows, Android, STM32, NXP, ESP32, Nordic, TI, Microchip, Infineon, Renesas and other chips
  • write code once - and it'll work everywhere
  • ideal for the unification of the network infrastructure code across company
  • Built-in protocols: plain TCP/UDP, SNTP, HTTP, MQTT, Websocket, Modbus-TCP, and other
  • Asynchronous DNS resolver
  • Tiny static and run-time footprint
  • Source code is both ISO C and ISO C++ compliant
  • Very easy to integrate
  • Own TCP/IP stack for bare metal / RTOS, or run on top of any existing one (lwIP, Zephyr, ...)
  • Built-in TLS 1.3 stack. Also can use external TLS libraries - mbedTLS, OpenSSL, or other
  • Does not depend on any other software to implement networking
  • Built-in firmware updates for STM32 H5, STM32 H7, NXP IMXRT, RP2040/2350, ESP32 and more
  • Commercial support with proactive security updates; CRA-compliant

Mongoose is ideal for IoT devices, embedded web servers, OTA updates, MQTT telemetry, secure device dashboards, REST APIs on microcontrollers

See https://mongoose.ws/ for complete documentation, videos, case studies, etc.

Supported platforms

Mongoose has its own built-in TCP/IP stack with drivers, so it needs no additional software to implement networking. The built-in stack runs on bare metal and under any RTOS. Platforms supported by the Mongoose built-in TCP/IP stack:

MCU Connectivity Notes
STM32 Built-in Ethernet Ethernet-capable STM32F, STM32H5, STM32H7, STM32N6, STM32C5 variants
NXP i.MX RT Built-in Ethernet RT102x, RT104x, RT105x, RT106x, RT117x, RT118x (NETC)
NXP MCX Built-in Ethernet MCXN94x, MCXE247
NXP RW612 Eth, WiFi, 802.15.4 Separate Ethernet and radio drivers
Microchip ATSAME54 Built-in Ethernet GMAC driver
Renesas RA Built-in Ethernet RA6M, RA8M
Infineon XMC Built-in Ethernet XMC4, XMC7
Texas Instruments Built-in Ethernet TM4C, TMS570
RP2040, RP2350, STM32, others CYW43xx Wi-Fi chips SPI or SDIO; Pico W, Pico 2 W, Pico RM2, Arduino Portenta H7
STM32, others ST67W6 Wi-Fi modules SPI; for example, STM32U5 with the ST67W611M1 module
MCUs with an NXP Wi-Fi SDK port NXP Wi-Fi Requires the SDK's Wi-Fi port implementing the driver's network hooks
NXP MCXW71 Built-in 802.15.4 radio IPv4 over IEEE 802.15.4
NXP RW612 Built-in 802.15.4 radio IPv4 over IEEE 802.15.4; requires NXP radio firmware
Any MCU with SPI W5500 or W5100 Ethernet chips External Wiznet MAC+PHY
MCUs connected to a cellular modem Cellular AT commands and PPP; for example, SIM800
MCUs with CMSIS Ethernet drivers Ethernet via CMSIS-Driver Requires CMSIS Ethernet MAC and PHY drivers

Mongoose can also run on top of any TCP/IP stack that supports the BSD sockets API. Platforms supported via 3rd party TCP/IP stacks:

TCP/IP stack Notes
lwIP All devices running lwIP, for example ESP32, ESP32S3, ESP32C3, ESP32C6, etc
Zephyr All devices supported by Zephyr
Other Any other TCP/IP stack that supports BSD socket API, for example Amazon FreeRTOS-TCP
Linux, Mac, Windows Workstations, server, single board computers, embedded Linux devices running on MPUs or FPGAs

Usage Examples

Below are quick snippets that should give an idea how simple the API is and how easy it is to create applications with it.

Create a simple web server that serves a directory. The behavior of the HTTP server is specified by its event handler function:

#include "mongoose.h"   // To build, run: cc main.c mongoose.c

// HTTP server event handler function
void ev_handler(struct mg_connection *c, int ev, void *ev_data) {
  if (ev == MG_EV_HTTP_MSG) {
    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
    struct mg_http_serve_opts opts = { .root_dir = "./web_root/" };
    mg_http_serve_dir(c, hm, &opts);
  }
}

int main(void) {
  struct mg_mgr mgr;  // Declare event manager
  mg_mgr_init(&mgr);  // Initialise event manager
  mg_http_listen(&mgr, "http://0.0.0.0:8000", ev_handler, NULL);  // Setup listener
  for (;;) {          // Run an infinite event loop
    mg_mgr_poll(&mgr, 1000);
  }
  return 0;
}

HTTP server implements a REST API that returns current time. JSON formatting:

static void ev_handler(struct mg_connection *c, int ev, void *ev_data) {
  if (ev == MG_EV_HTTP_MSG) {
    struct mg_http_message *hm = (struct mg_http_message *) ev_data;
    if (mg_match(hm->uri, mg_str("/api/time/get"), NULL)) {
      mg_http_reply(c, 200, "", "{%m:%lu}\n", MG_ESC("time"), time(NULL));
    } else {
      mg_http_reply(c, 500, "", "{%m:%m}\n", MG_ESC("error"), MG_ESC("Unsupported URI")); 
    }
  }
}

MQTT client that subscribes to a topic device1/rx and echoes incoming messages to device1/tx:

#include "mongoose.h"

static const char *s_mqtt_url = "mqtt://broker.hivemq.com:1883";
static struct mg_connection *s_mqtt_conn = NULL;

// MQTT connection event handler function
static void ev_handler(struct mg_connection *c, int ev, void *ev_data) {
  if (ev == MG_EV_OPEN) {
    MG_INFO(("%lu created, connecting to %s ...", c->id, s_mqtt_url));
  } else if (ev == MG_EV_MQTT_OPEN) {
    struct mg_mqtt_opts opts = {.qos = 1, .topic = mg_str("device1/rx")};
    mg_mqtt_sub(c, &opts);
    MG_INFO(("%lu connected, subscribing to %s", c->id, opts.topic.buf));
  } else if (ev == MG_EV_MQTT_MSG) {
    char response[100];
    struct mg_mqtt_message *mm = (struct mg_mqtt_message *) ev_data;
    struct mg_mqtt_opts opts = {.qos = 1, .topic = mg_str("device1/tx")};
    mg_snprintf(response, sizeof(response), "Received [%.*s] / [%.*s]",
                mm->topic.len, mm->topic.buf, mm->data.len, mm->data.buf);
    opts.message = mg_str(response);
    mg_mqtt_pub(c, &opts);
  } else if (ev == MG_EV_CLOSE) {
    MG_INFO(("%u closing", c->id));
    s_mqtt_conn = NULL;
  }
}

// Reconnection timer function. If we get disconnected, reconnect again
static void timer_fn(void *arg) {
  struct mg_mgr *mgr = (struct mg_mgr *) arg;
  if (s_mqtt_conn == NULL) {
    struct mg_mqtt_opts opts = {.clean = true};
    s_mqtt_conn = mg_mqtt_connect(mgr, s_mqtt_url, &opts, ev_handler, NULL);
  }
}

int main() {
  struct mg_mgr mgr;  // Mongoose event manager. Holds all connections
  mg_mgr_init(&mgr);  // Initialise event manager
  mg_timer_add(&mgr, 3000, MG_TIMER_REPEAT | MG_TIMER_RUN_NOW, timer_fn, &mgr);
  for (;;) {
    mg_mgr_poll(&mgr, 1000);  // Infinite event loop
  }
  return 0;
}

Licensing

Mongoose is dual-licensed: - GPLv2: free for open source projects. Many popular open source projects use Mongoose, for example SWUpdate, the embedded Linux update framework - Commercial: for closed-source products. Includes support directly from the engineers who wrote the whole stack, and early security fixes. See licensing

Commercial use

  • Mongoose is used by hundreds of businesses, from Fortune500 giants like Siemens, Schneider Electric, Broadcom, Bosch, Google, Samsung, Qualcomm, Caterpillar to the small businesses
  • Used to solve a wide range of business needs, like implementing Web UI interface on devices, RESTful API services, telemetry data exchange, remote control for a product, remote software updates, remote monitoring, and others
  • Deployed to hundreds of millions devices in production environment worldwide
  • See Case Studies from our respected customers like Schneider Electric (industrial automation), Broadcom (semiconductors), Pilz (industrial automation), and others
  • See Testimonials from engineers that integrated Mongoose in their commercial products
  • We provide Evaluation and Commercial licensing, support, consultancy and integration services - don't hesitate to contact us

Security

We take security seriously: 1. Mongoose repository runs a continuous integration test powered by GitHub, which runs through hundreds of unit tests on every commit to the repository. Our unit tests are built with modern address sanitizer technologies, which help to find security vulnerabilities early 2. Mongoose repository is integrated into Google's oss-fuzz continuous fuzzer which scans for potential vulnerabilities continuously 3. We receive periodic vulnerability reports from the independent security groups like Cisco Talos, Microsoft Security Response Center, MITRE Corporation, Compass Security and others. In case of the vulnerability found, we act according to the industry best practice: hold on to the publication, fix the software and notify all our customers that have an appropriate subscription 4. Some of our customers (for example NASA) have specific security requirements and run independent security audits, of which we get notified and in case of any issue, act similar to (3).

How to report security vulnerabilities

Please report via https://github.com/cesanta/mongoose/security/advisories. Do NOT create a github issue.

Articles

Technical guides and deep dives into embedded web servers, WebUI integration and embedded networking technologies: - Embedded Web Server: A Comprehensive Guide for Modern Connected Devices - Building Embedded Web Device Dashboards - ESP32 Device Dashboard: A Step-by-Step Guide for Developers - How to build an STM32 Web Dashboard - STM32 WebSocket Guide - Web File Manager on STM32, ESP32 and Embedded Linux - Web dashboard on Zephyr RTOS - Limiting TCP/IP RAM usage on STM32 - STM32 Ethernet explained - MQTT on a Microcontroller - STM32 OTA Firmware Update - RP2350 OTA Firmware Update - STM32 Ethernet and caches - NXP RW612 OTA Firmware Update - lwIP vs Mongoose - TCP/IP Stack Integration Benchmark - Embedded TCP/IP Stacks Comparison - STM32H5 File System on Internal Flash: LittleFS + Mongoose - Firmware OTA and remote control on NXP FRDM-RW612 - 25000 WebSocket messages per second on STM32 Nucleo-H723ZG - How to connect STM32 to AWS IoT Core - How to connect STM32 to Azure IoT Hub - How to connect STM32 to EMQX - [STM32 Device Management deep dive: Secure OTA, Remote Control, health monitor](https://mongoose.ws/articles/stm32-mdash-deep-

Core symbols most depended-on inside this repo

browse all functions →

Shape

Function 18,146
Class 2,729
Enum 81

Languages

C52%
C++44%
TypeScript4%

Modules by API surface

test/mongoose.c1,493 symbols
mongoose.c1,493 symbols
tutorials/stm32/nucleo-h723zg/cubemx/Drivers/STM32H7xx_HAL_Driver/Inc/stm32h7xx_ll_rcc.h323 symbols
tutorials/stm32/nucleo-h723zg/cubemx-freertos/Drivers/STM32H7xx_HAL_Driver/Inc/stm32h7xx_ll_rcc.h323 symbols
tutorials/stm32/nucleo-h563zi/cubemx/Drivers/STM32H5xx_HAL_Driver/Inc/stm32h5xx_ll_rcc.h304 symbols
tutorials/stm32/nucleo-h723zg/cubemx/Drivers/STM32H7xx_HAL_Driver/Inc/stm32h7xx_ll_usart.h249 symbols
tutorials/stm32/nucleo-h723zg/cubemx-freertos/Drivers/STM32H7xx_HAL_Driver/Inc/stm32h7xx_ll_usart.h249 symbols
tutorials/stm32/nucleo-h563zi/cubemx/Drivers/STM32H5xx_HAL_Driver/Inc/stm32h5xx_ll_usart.h249 symbols
tutorials/stm32/nucleo-h563zi/cubemx/littlefs/lfs.c217 symbols
test/mongoose.h209 symbols
mongoose.h209 symbols
test/unit_test.c179 symbols

For agents

$ claude mcp add mongoose \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page