AWS IoT Greengrass runtime for constrained devices.
The Greengrass nucleus lite provides a lightweight alternative to the Greengrass nucleus runtime.
The nucleus lite aims to be compatible with the Greengrass nucleus, but implements a subset of its functionality. Expect future releases to reduce the feature gap.
See the build guide for instructions to build and install Greengrass Nucleus Lite from source.
To configure and run Greengrass Nucleus Lite, see the setup guide.
For setting up as a Greengrass developer, also see the developer setup guide.
For AI agent driven getting started please follow the instruction from the greengrass-agent-context-pack github repo.
For easy device onboarding and example implementation, you may want to check out Avnet's workshop.
Furthermore you can visit Avnet's IOTCONNECT Greengrass repository on GitHub for SDKs and Quick Start guides that support platforms such as STM32, Renesas, NXP and Raspberry Pi.
The git tags in this repository represent stable, fully tested releases. Please use these for production environments.
The main branch contains ongoing development work and:
- May contain untested features.
- Could include breaking changes.
- Is not recommended for production use.
RISC-V architecture support is experimental and not fully tested. Use with caution in production environments.
IPC support is provided by ggipcd. The support translates the IPC command to corebus. This table identifies the corebus component that does the work.
| Feature | Daemon that provides support |
|---|---|
| SubscribeToTopic | ggpubsubd |
| PublishToTopic | ggpubsubd |
| PublishToIoTCore | iotcored |
| SubscribeToIoTCore | iotcored |
| GetConfiguration | ggconfigd |
| UpdateConfiguration | ggconfigd |
| SubscribeToConfigurationUpdate | ggconfigd |
| CreateLocalDeployment | ggdeploymentd |
| ValidateAuthorizationToken | ggipcd |
| RestartComponent | gghealthd |
| UpdateState | gghealthd |
Additional IPC commands will be supported in future releases.
Known issues are documented here with some potential workarounds. Additionally, only basic recipe types are supported, more information on missing features can be found here.
See CONTRIBUTING for more information.
This project is licensed under the Apache-2.0 License.
