Amazon FreeRTOS
User Guide

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


Make sure that your host machine meets the following prerequisites before continuing:

  • Your device's compilation toolchain must support the machine's operating system. CMake supports all versions of Windows, macOS, and Linux

    Windows subsystem for Linux (WSL) is not supported. Use native CMake on Windows machines.

  • You must have CMake version 3.13 or higher installed.

    You can download the binary distribution of CMake from


    If you download the binary distribution of CMake, make sure that you add the CMake executable to the PATH environment variable before you using CMake from command line.

    You can also download and install CMake using a package manager, like homebrew on macOS, and scoop or chocolatey on Windows.


    The CMake package versions provided in the package managers for many Linux distributions are out-of-date. If your distribution's package manager does not provide the the latest version of CMake, you can try alternative package managers, like linuxbrew or nix.

  • You must have a compatible native build system.

    CMake can target many native build systems, including GNU Make or Ninja. Both Make and Ninja can be installed with package managers on Linux, macOS and Windows. If you are using Make on Windows, you can install a standalone version from Equation, or you can install MinGW, which bundles make.


    The Make executable in MinGW is called mingw32-make.exe, instead of make.exe.

    We recommend that you use Ninja, as it is faster than Make and also provides native support to all desktop operating systems.