Build tools

The following instructions guide on setting up a development environment for building and running Mongoose Library examples, as well as developing new applications. The required tools are:

If you are going to build for embedded systems, extra tools are required:

MacOS setup instructions

Start a terminal, and execute:

/bin/bash -c "$(curl -fsSL"
brew install gcc make git gcc-arm-embedded stlink cmake uniflash riscv-tools

Linux setup instructions

Assuming Ubuntu Linux. Start a terminal, and execute:

sudo apt -y update
sudo apt -y install build-essential make gcc-arm-none-eabi stlink-tools git cmake gcc-riscv64-unknown-elf

Windows setup instructions

  • Enable "Developer Mode" in Windows 10/11, for symbolic link support. "Open Settings" / "Privacy & Security" / "For developers", then set the "Developer Mode" to "on".
  • Install Git from Check "Enable symlink" during installation. If you have Git already installed, either reinstall it with the symlink support on, or run a git config --global core.symlinks true in the command prompt to enable symlinks in Git
  • Download and run mingwInstaller.exe
    • Set install destination to c:\
    • Accept suggested default settings
    • Go to c:\mingw32\bin folder and rename mingw32-make.exe to make.exe
    • Add c:\mingw32\bin to the Path environment variable
  • for ARM embedded systems Download and install gcc-arm-none-eabi-10.3-2021.10-win32.exe.
    • Enable "Add path to environment variable" during the installation
  • for RISCV embedded systems Download and install risc-v-gcc10.1.0.exe, accept default installation settings.
  • for RP2040 devices Install CMake; choose "Add CMake to the system PATH". You may also need to install Python 3
  • for STM32 devices Create c:\tools folder.
    • Download and unpack bin/st-flash.exe into the c:\tools folder
    • Add c:\tools to the Path environment variable
    • If st-link does not work, you need a driver. Unplug your board and install ST's ST-LINK driver
      • Alternatively, you may install Zadig; it will detect the device missing a driver and let you install a proper one. However, this is not compatible with Keil. Try WinUSB first:Zadig WinUSB driver
  • for TI devices Download and install the Uniflash utility

Build and run an example

Now, when all required tools are installed, start terminal/command prompt, download Mongoose repository, go to HTTP server example, build it and run it:

git clone
cd mongoose/examples/http-server