# Get Started with FreeRTOS
<a name="freertos-getting-started"></a>

**Important**  <a name="deprecation-message-general"></a>
This page refers to the Amazon-FreeRTOS repository which is deprecated. We recommend that you [start here](freertos-getting-started-modular.md) when you create a new project. If you already have an existing FreeRTOS project based on the now deprecated Amazon-FreeRTOS repository, see the [Amazon-FreeRTOS Github Repository Migration Guide](github-repo-migration.md).

This Getting Started with FreeRTOS tutorial shows you how to download and configure FreeRTOS on a host machine, and then compile and run a simple demo application on a [ qualified microcontroller board](https://devices.amazonaws.com/search?page=1&sv=freertos).

Throughout this tutorial, we assume that you are familiar with Amazon IoT and the Amazon IoT console. If not, we recommend that you complete the [Amazon IoT Getting Started](https://docs.amazonaws.cn/iot/latest/developerguide/iot-gs.html) tutorial before you continue.

**Topics**
+ [FreeRTOS demo application](freertos-getting-started-demo.md)
+ [First steps](freertos-prereqs.md)
+ [Troubleshooting getting started](gsg-troubleshooting.md)
+ [Using CMake with FreeRTOS](getting-started-cmake.md)
+ [Developer-mode key provisioning](dev-mode-key-provisioning.md)
+ [Board-specific getting started guides](getting-started-guides.md)
+ [Next steps with FreeRTOS](getting-started-next-steps.md)