Document history for the Amazon IoT Greengrass V2 Developer Guide - Amazon IoT Greengrass
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Document history for the Amazon IoT Greengrass V2 Developer Guide

The following table describes the documentation for this release of Amazon IoT Greengrass Version 2.

  • API version: 2020-11-30

ChangeDescriptionDate

Stream manager v2.1.13 released

Stream manager v2.1.13 is now available. This release adds support for FIPS endpoint for Amazon IoT SiteWise

August 26, 2024

Shadow manager v2.3.9 released

Shadow manager v2.3.9 is available.

August 26, 2024

Modbus-RTU protocol adapter v2.1.9 released

Modbus-RTU protocol adapter component v2.1.9 is available.

August 26, 2024

Log manager v2.3.8 released

Log manager component v2.3.8 is available.

August 26, 2024

Local debug console v2.4.3 released

Local debug console component v2.4.3 is available. This version includes general bug fixes and improvements.

August 26, 2024

Disk spooler v1.0.4 released

Disk spooler component v1.0.4 is available.

August 26, 2024

Amazon IoT Greengrass Core v2.13.0 software update

This release provides version 2.13.0 of the Greengrass nucleus component.

August 26, 2024

New nucleus telemetry emitter component

Version 1.0.9 of the nucleus telemetry emitter component is available.

August 23, 2024

Lambda manager v2.3.4 released

Lambda manager component v2.3.4 is available.

August 23, 2024

Greengrass CLI v2.13.0 released

Greengrass CLI component v2.13.0 is available.

August 23, 2024

Client device auth component v2.5.1 released

Client device auth component v2.5.0 is available. This release adds support for FIPS endpoint.

August 23, 2024

Recipe validation

Added a recipe validation feature that will validate a component recipe when creating a component version.

August 15, 2024

IP detector v2.2.0 released

IP detector component v2.2.0 is available. This release adds support for IPv6. You can now use IPv6 for local messaging.

July 29, 2024

Shadow manager v2.3.8 released

Shadow manager v2.3.8 is available. This release fixes an issue where shadow manager creates a deadlock situation during the MQTT client connection.

June 5, 2024

Greengrass CLI v2.12.6 released

Greengrass CLI component v2.12.6 is available.

May 24, 2024

Amazon IoT Greengrass Core v2.12.6 software update

This release provides version 2.12.6 of the Greengrass nucleus component and updates Amazon-provided components.

May 24, 2024

Amazon IoT Device Tester v4.9.4 with GGV2Q v2.5.4 released

Version 4.9.4 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.5.4, and supports Greengrass nucleus versions 2.12.0, 2.11.0, 2.10.0, 2.9.5.

May 3, 2024

Secure tunneling v1.0.19 released

Secure tunneling v1.0.19 is available. This version upgrades the underlying Amazon IoT Device Client invoked by the component from version 1.8.0 to version 1.9.0. Secure tunneling v1.0.19 increases the concurrent tunnel limit to 20 tunnels on a component level. This new version also increases Amazon IoT Greengrass Core IPC timeout from 3 seconds to 10 seconds.

May 1, 2024

Edge connector for Kinesis Video Streams component v1.0.5 released

Version 1.0.5 of the edge connector for Kinesis Video Streams component is available. This version includes general bug fixes and improvements.

April 29, 2024

Greengrass CLI v2.12.5 released

Greengrass CLI component v2.12.5 is available.

April 25, 2024

Client device auth component v2.5.0 released

Client device auth component v2.5.0 is available. This release adds policy variable support for thing names. This release also allows policy resources with wildcards.

April 25, 2024

Amazon IoT Greengrass Core v2.12.5 software update

This release provides version 2.12.5 of the Greengrass nucleus component and updates Amazon-provided components.

April 25, 2024

Amazon IoT Device Tester v4.9.3 with GGV2Q v2.5.3 released

Version 4.9.3 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.5.3, and supports Greengrass nucleus versions 2.12.0, 2.11.0, 2.10.0, 2.9.5.

April 5, 2024

Greengrass CLI v2.12.4 released

Greengrass CLI component v2.12.4 is available.

April 2, 2024

Amazon IoT Greengrass Core v2.12.4 software update

This release provides version 2.12.4 of the Greengrass nucleus component and updates Amazon-provided components.

April 2, 2024

Shadow manager v2.3.7 released

Shadow manager v2.3.7 is available. This release fixes an issue where shadow manager periodically logs a NullPointerException error during a shadow manager sync.

March 27, 2024

Moquette MQTT 3.1.1 broker v2.3.6 released

Moquette MQTT 3.1.1 broker component v2.3.6 is available. This version includes general bug fixes and improvements.

March 27, 2024

Local debug console v2.4.2 released

Local debug console component v2.4.2 is available. This version includes general bug fixes and improvements.

March 27, 2024

Lambda manager v2.3.3 released

Lambda manager component v2.3.3 is available. This version includes general bug fixes and improvements.

March 27, 2024

IP detector v2.1.9 released

IP detector component v2.1.9 is available. This release adjusts the IP acquired step to only send logs at the debug log level.

March 27, 2024

Amazon IoT fleet provisioning plugin v1.2.1 released

Amazon IoT fleet provisioning plugin v1.2.1 is available. This release fixes an issue where the fleet provisioning plugin is offline during a Greengrass nucleus startup. The fleet provisioning plugin now indefinitely retries MQTT connect calls.

March 27, 2024

Amazon IoT Greengrass Core v2.12.3 software update

This release provides version 2.12.3 of the Greengrass nucleus component and updates Amazon-provided components.

March 27, 2024

Greengrass CLI v2.12.3 released

Greengrass CLI component v2.12.3 is available.

March 25, 2024

Amazon IoT Device Tester v4.9.2 with GGV2Q v2.5.2 released

Version 4.9.2 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.5.2, and supports Greengrass nucleus versions 2.12.0, 2.11.0, 2.10.0, 2.9.5.

March 18, 2024

Lookout for Vision edge agent v1.2.0 released

Lookout for Vision edge agent v1.2.0 is available.

March 11, 2024

Amazon IoT Greengrass Core v2.12.2 software update

This release provides version 2.12.2 of the Greengrass nucleus component and updates Amazon-provided components.

February 15, 2024

Shadow manager v2.3.6 released

Shadow manager v2.3.6 is available. This release fixes an issue where shadow properties that are deleted through Amazon Web Services Cloud updates while the device is offline continue to exist in the local shadow after regaining connectivity.

February 14, 2024

Lambda launcher v2.0.13 released

Version 2.0.13 of the Lambda launcher component is available. This release includes general bug fixes and improvements.

February 14, 2024

Disk spooler v1.0.3 released

Disk spooler component v1.0.3 is available. This release improves performance by reusing database connections.

February 14, 2024

Lookout for Vision edge agent v1.1.9 released

Lookout for Vision edge agent v1.1.9 is available.

January 17, 2024

Greengrass Development Kit CLI v1.6.2

Version 1.6.2 of the Greengrass Development Kit CLI is available. This version fixes an issue where Windows gradlew.bat does not work due to the relative path. This version also contains additional improvements.

January 16, 2024

New CloudTrail data events

You can now log Amazon CloudTrail data events to get information about resource operations such as getting a component or the configuration of a deployment. Use these events to gain insight into the operation of your Greengrass devices.

December 20, 2023

Lookout for Vision edge agent v1.1.8 released

Lookout for Vision edge agent v1.1.8 is available.

December 12, 2023

Stream manager v2.1.12 released

Stream manager v2.1.12 is now available. This release changes the order that Greengrass uses to select a set of credentials for Amazon service calls.

December 8, 2023

MQTT bridge v2.3.1 released

MQTT bridge v2.3.1 is available. This release fixes a rare issue where the local MQTT client gets into a disconnect loop.

December 8, 2023

Disk spooler v1.0.2 released

Disk spooler component v1.0.2 is available. This release fixes an issue where the MQTT message format field isn't persisted in certain cases.

December 8, 2023

Client device auth component v2.4.5 released

Client device auth component v2.4.5 is available. This release adds support for wildcards at the end of thing names in a selection rule and fixes an issue where certificates are not updated with new connectivity info in certain cases.

December 8, 2023

Amazon IoT Greengrass Core v2.12.1 software update

This release provides version 2.12.1 of the Greengrass nucleus component and updates Amazon-provided components.

December 8, 2023

Greengrass Development Kit CLI v1.6.1

Version 1.6.1 of the Greengrass Development Kit CLI is available. This version contains bug fixes and improvements.

December 6, 2023

Recipe validation

Added a recipe validation feature that will validate a component recipe when creating a component version.

November 16, 2023

Publisher-supported components

Amazon IoT Greengrass now offers Publisher-supported components. These components are developed, offered, and serviced by third-party vendors.

November 16, 2023

Greengrass Testing Framework v1.2.0 released

Greengrass Testing Framework v1.2.0 is available.

November 15, 2023

Greengrass Development Kit CLI v1.6.0

Version 1.6.0 of the Greengrass Development Kit CLI is available. This version adds a recipe validation check against the Greengrass recipe schema during the component build and component publish commands. This update helps developers to identify actionable issues within their component recipes earlier in the component creation process. This version also adds a confidence test suite to the template that can be pulled down by the test-e2e init command. This confidence test suite includes eight generic tests that can be used and extended to fit basic component testing needs.

November 15, 2023

Amazon IoT Device Tester v4.9.1 supports Greengrass nucleus version 2.12.0

Version 4.9.1 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.12.0.

November 7, 2023

Amazon IoT Greengrass Core v2.12.0 software update

This release provides version 2.12.0 of the Greengrass nucleus component and updates Amazon-provided components.

November 7, 2023

Operate a Greengrass core device in VPC

Operating a Greengrass core device in VPC is available. This feature enables you to perform deployments in VPC without public internet access.

November 3, 2023

Greengrass CLI v2.12.0 released

Greengrass CLI component v2.12.0 is available.

October 30, 2023

Stream manager v2.1.10 released

Stream manager v2.1.10 is now available. This release fixes an issue where the HTTPS proxy configuration doesn't trust the Greengrass CA certificate chain.

October 26, 2023

Lambda launcher v2.0.12 released

Version 2.0.12 of the Lambda launcher component is available. This release fixes an issue where the Lambda launcher could throw an error if the previous process was not stopped properly.

October 26, 2023

Greengrass Development Kit CLI v1.5.0

Version 1.5.0 of the Greengrass Development Kit CLI is available. This version updates the patterns recognized by the excludes build option when build_system is zip. This version will now recognize glob patterns which match pathnames based on their wildcard characters. This enables custom specification of which directories to exclude from.

October 26, 2023

Lookout for Vision edge agent v1.1.7 released

Lookout for Vision edge agent v1.1.7 is available.

October 24, 2023

Shadow manager v2.3.4 released

Shadow manager v2.3.4 is available. This release adds support for null and empty shadow state documents.

October 18, 2023

Log manager v2.3.6 released

Log manager component v2.3.6 is available.

October 18, 2023

Local debug console v2.4.0 released

Local debug console component v2.4.0 is available.

October 18, 2023

Lambda manager v2.3.1 released

Lambda manager component v2.3.1 is available.

October 18, 2023

Greengrass CLI v2.11.3 released

Greengrass CLI component v2.11.3 is available.

October 18, 2023

Amazon IoT Greengrass Core v2.11.3 software update

This release provides version 2.11.3 of the Greengrass nucleus component and updates Amazon-provided components.

October 18, 2023

Secure tunneling v1.0.17 released

Secure tunneling v1.0.17 is available.

October 4, 2023

Greengrass Development Kit CLI v1.4.0

Version 1.4.0 of the Greengrass Development Kit CLI is available. This version adds a new config command that starts an interactive prompt to modify fields within an existing GDK configuration file. This version also modifies the gdk component build and gdk component publish commands to verify that the recipe size is within Greengrass requirements (<=16000 bytes) before proceeding.

October 2, 2023

Moquette MQTT 3.1.1 broker v2.3.5 released

Moquette MQTT 3.1.1 broker component v2.3.5 is available. This version updates Moquette to version 0.17.

September 28, 2023

MQTT bridge v2.3.0 released

MQTT bridge v2.3.0 is available. This release adds MQTT 5 support for bridging between Amazon IoT Core and local MQTT sources.

September 28, 2023

Lookout for Vision edge agent v1.1.6 released

Lookout for Vision edge agent v1.1.6 is available.

September 27, 2023

Lambda manager v2.3.0 released

Lambda manager component v2.3.0 is available.

September 15, 2023

Lambda launcher v2.0.11 released

Version 2.0.11 of the Lambda launcher component is available. This version supports Lambda Manager 2.3.0.

September 15, 2023

Moquette MQTT 3.1.1 broker v2.3.4 released

Moquette MQTT 3.1.1 broker component v2.3.4 is available.

September 1, 2023

Greengrass Testing Framework

GTF is a collection of building blocks to support end-to-end automation. It enables Amazon IoT Greengrass Version 2 internal customers to use the same testing framework that the service team uses for qualifying software changes, automated acceptance, and quality assurance purposes.

August 11, 2023

Amazon IoT Greengrass Core v2.11.2 software update

This release provides version 2.11.2 of the Greengrass nucleus component and updates Amazon-provided components.

August 9, 2023

Greengrass Development Kit CLI v1.3.0

Version 1.3.0 of the Greengrass Development Kit CLI is available. This version adds a new test-e2e command to support end-to-end testing of components using Open Test Framework.

July 21, 2023

Amazon IoT Greengrass Core v2.11.1 software update

This release provides version 2.11.1 of the Greengrass nucleus component and updates Amazon-provided components.

July 21, 2023

Disk spooler v1.0.0 released

Disk spooler component v1.0.0 is available.

June 28, 2023

Amazon IoT Greengrass Core v2.11.0 software update

This release provides version 2.11.0 of the Greengrass nucleus component and updates Amazon-provided components.

June 28, 2023

Amazon IoT Greengrass Core v2.10.3 software update

This release provides version 2.10.3 of the Greengrass nucleus component and updates Amazon-provided components.

June 21, 2023

Amazon IoT Greengrass Core v2.10.2 software update

This release provides version 2.10.2 of the Greengrass nucleus component and updates Amazon-provided components.

June 5, 2023

Amazon IoT Greengrass Core v2.10.1 software update

This release provides version 2.10.1 of the Greengrass nucleus component and updates Amazon-provided components.

May 11, 2023

Amazon IoT Greengrass Core v2.10.0 software update

This release provides version 2.10.0 of the Greengrass nucleus component and updates Amazon-provided components.

May 9, 2023

SageMaker Edge Manager discontinued

Amazon SageMaker Edge Manager component is being discontinued on April 26, 2024.

April 28, 2023

Amazon IoT Greengrass Core v2.9.6 software update

This release provides version 2.9.6 of the Greengrass nucleus component and updates Amazon-provided components.

April 20, 2023

Log manager v2.3.2 released

Log manager component v2.3.2 is available.

April 19, 2023

Stream manager v2.1.4 released

Stream manager v2.1.4 is now available. This release fixes an issue where entries for the same property asset with the same timestamp within a single batch return ConflictingOperationException from the SiteWise API which causes stream manager to continuously retry. This release also updates the default connection timeout from 3 seconds to 1 minute.

April 13, 2023

Greengrass Development Kit CLI v1.2.3

Version 1.2.3 of the Greengrass Development Kit CLI is available. This version contains bug fixes.

April 13, 2023

Client device auth component v2.4.0 released

Client device auth component v2.4.0 is available. This release adds support for client device auth to emit operational metrics that can be displayed on the Greengrass Client Device dashboard.

April 10, 2023

Greengrass Development Kit CLI v1.2.2

Version 1.2.2 of the Greengrass Development Kit CLI is available. This version contains improvements and bug fixes.

April 7, 2023

Amazon IoT Greengrass Core v2.9.5 software update

This release provides version 2.9.5 of the Greengrass nucleus component and updates Amazon-provided components.

March 30, 2023

Stream manager v2.1.3 released

Stream manager v2.1.3 is now available. This release fixes a startup issue on Windows OS when running as the SYSTEM user.

March 7, 2023

Modbus-RTU protocol adapter v2.1.5 released

Modbus-RTU protocol adapter component v2.1.5 is available. This release fixes an issue with the ReadDiscreteInput operation.

March 7, 2023

Client device auth component v2.3.2 released

Client device auth component v2.3.2 is available. This release adds support for caching hostname information so that the component correctly generates certificate subjects when restarted while offline.

March 7, 2023

Amazon IoT Device Tester v4.7.0 supports Greengrass nucleus version 2.9.4

Version 4.7.0 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.9.4.

March 2, 2023

Greengrass Command Line Interface v1.2.0 released

Greengrass Command Line Interface v1.2.0 is available.

February 28, 2023

Amazon IoT Greengrass Core v2.9.4 software update

This release provides version 2.9.4 of the Greengrass nucleus component and updates Amazon-provided components.

February 24, 2023

Shadow manager v2.3.1 released

Shadow manager v2.3.1 is available. This release fixes a condition that may prevent cloud shadow updates from syncing. This release also fixes an issue where changes to named shadow sync configuration applies to only one named shadow.

February 21, 2023

Amazon IoT Device Tester v4.7.0 supports Greengrass nucleus version 2.9.3

Version 4.7.0 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.9.3.

February 9, 2023

IAM best practices updated

Updated guide to align with the IAM best practices. For more information, see Security best practices in IAM.

February 3, 2023

Amazon IoT Greengrass Core v2.9.3 software update

This release provides version 2.9.3 of the Greengrass nucleus component and updates Amazon-provided components.

February 1, 2023

Log manager v2.3.1 released

Log manager v2.3.1 is available.

January 27, 2023

Amazon IoT Device Tester v4.7.0 supports Greengrass nucleus version 2.9.2

Version 4.7.0 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.9.2.

January 3, 2023

Shadow manager v2.3.0 released

Shadow manager v2.3.0 is available. This release fixes an issue that might prevent shadows from syncing when a device stores the Greengrass device private key in a hardware security module.

December 29, 2022

Amazon IoT fleet provisioning plugin v1.2.0 released

Amazon IoT fleet provisioning plugin v1.2.0 is available. This release adds support for device provisioning via certificate signing request with configurable private key path.

December 22, 2022

Amazon IoT Greengrass Core v2.9.2 software update

This release provides version 2.9.2 of the Greengrass nucleus component and updates Amazon-provided components.

December 22, 2022

Amazon IoT Device Tester v4.7.0 with GGV2Q v2.5.0 released

Version 4.7.0 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.5.0, and supports Greengrass nucleus versions 2.9.1, 2.9.0, 2.8.1, 2.8.0, 2.7.0, and 2.6.0.

December 13, 2022

Shadow manager v2.2.4 released

Fixes an issue where the validation of the shadow's size wasn't consistent with the cloud when updating the local shadow document. This also fixes an issue where the shadow manager stops listening to configuration updates if a deployment performs a RESET on the configuration nodes.

December 8, 2022

Lookout for Vision Edge Agent 1.1.1 released

Lookout for Vision Edge Agent component v1.1.1 is available.

December 5, 2022

Log manager v2.3.0 released

Log manager component v2.3.0 is available.

November 18, 2022

Amazon IoT Device Tester v4.5.11 supports Greengrass nucleus version 2.9.1

Version 4.5.11 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.9.1.

November 18, 2022

Amazon IoT Greengrass Core v2.9.1 software update

This release provides version 2.9.1 of the Greengrass nucleus component and updates Amazon-provided components.

November 18, 2022

Amazon IoT Device Tester v4.5.11 supports Greengrass nucleus version 2.9.0

Version 4.5.11 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.9.0.

November 17, 2022

Stream manager v2.1.2 released

Stream manager v2.1.2 is now available. This release fixes an issue on Windows OS that use a non-English language.

November 15, 2022

Amazon IoT Greengrass Core v2.9.0 software update

This release provides version 2.9.0 of the Greengrass nucleus component and updates Amazon-provided components.

November 15, 2022

Amazon IoT Device Tester v4.5.11 supports Greengrass nucleus version 2.8.1

Version 4.5.11 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.8.1.

October 19, 2022

Amazon IoT Device Tester v4.5.11 with GGV2Q v2.4.1 released

Version 4.5.11 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.4.1, and supports Greengrass nucleus versions 2.8.0, 2.7.0, and 2.6.0.

October 13, 2022

Amazon IoT Greengrass Core v2.8.1 software update

This release provides version 2.8.1 of the Greengrass nucleus component and updates Amazon-provided components.

October 13, 2022

Amazon IoT Greengrass Core v2.8.0 software update

This release provides version 2.8.0 of the Greengrass nucleus component and updates Amazon-provided components.

October 7, 2022

Added Amazon CloudFormation support for deployments

Amazon CloudFormation now supports Amazon IoT Greengrass deployments as a resource.

October 6, 2022

SageMaker Edge Manager v1.3.0 released

Amazon SageMaker Edge Manager component v1.3.0 is available. This release adds support for this component to set the disk size for the TensorRT model cache, and improves prediction concurrency to make better use of device accelerator engines such as GPUs.

September 1, 2022

Use interprocess communication (IPC) client V2

Added information about IPC client V2, which reduces the amount of code that you need to write to use IPC operations and helps avoid common errors that can occur with IPC client V1.

August 12, 2022

Amazon IoT Device Tester v4.5.8 with GGV2Q v2.4.0 released

Version 4.5.8 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.4.0, and supports Greengrass nucleus versions 2.7.0, 2.6.0, and 2.5.6.

August 12, 2022

SageMaker Edge Manager v1.2.0 released

Amazon SageMaker Edge Manager component v1.2.0 is available. This release adds support for this component to automatically retrieve SageMaker Neo-compiled models that you upload to Amazon S3, so you can deploy new models without needing to create a Amazon IoT Greengrass deployment.

August 3, 2022

Amazon IoT Device Tester v4.5.3 supports Greengrass nucleus version 2.7.0

Version 4.5.3 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.7.0.

August 1, 2022

Stream manager v2.1.0 released

Stream manager v2.1.0 is now available. This release includes support for you to send telemetry metrics to Amazon EventBridge.

July 28, 2022

Amazon IoT Greengrass Core v2.7.0 software update

This release provides version 2.7.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for you to send telemetry metrics to Amazon EventBridge.

July 28, 2022

IoT SiteWise publisher v2.2.0 released

IoT SiteWise publisher component v2.2.0 is available. This release updates the component to compress data before sending it to the Amazon IoT SiteWise service, which reduces bandwidth usage by up to 75 percent.

July 19, 2022

Tutorial: Develop a component that interacts with client device shadows

Added a new module to Tutorial: Interact with local IoT devices over MQTT that you can follow to learn how to develop a component that interacts with client device shadows.

July 18, 2022

Choose a local MQTT broker

Added information about how to choose a local MQTT broker where client devices connect to a core device.

July 18, 2022

Amazon IoT Device Tester v4.5.3 supports Greengrass nucleus version 2.6.0

Version 4.5.3 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.6.0.

June 29, 2022

Amazon IoT Greengrass Core v2.6.0 software update

This release provides version 2.6.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for client device shadows and a local MQTT 5 broker for client devices. It also includes support for wildcards in local publish/subscribe topics, recipe variables in component configurations, and wildcards in IPC authorization policies. These features enable you to more easily develop and configure components that you deploy to fleets of core devices. This release also includes support for components to use IPC operations that manage local deployments and components on a core device.

June 27, 2022

Client device component updates

Client device auth v2.1.0, MQTT broker (Moquette) v2.1.0, MQTT bridge v2.1.1, and IP detector v2.1.2 are available. This release improves certificate rotation, improves MQTT broker performance, and fixes issues with how these components handle configuration reset updates.

June 14, 2022

Amazon IoT Device Tester v4.5.3 supports Greengrass nucleus version 2.5.6

Version 4.5.3 of IDT for Amazon IoT Greengrass V2 now supports Greengrass nucleus version 2.5.6.

June 1, 2022

Amazon IoT Greengrass Core v2.5.6 software update

This release provides version 2.5.6 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for hardware security modules with ECC keys. It also includes other bug fixes and improvements.

May 31, 2022

Amazon IoT fleet provisioning plugin v1.1.0 released

Amazon IoT fleet provisioning plugin v1.1.0 is available. This release adds support for additional file path formats when you configure the plugin on Windows devices.

May 12, 2022

New Lambda runtimes released

Added support for new Lambda runtimes: Python 3.9, Java 11, and NodeJS 14.

May 10, 2022

Develop a Greengrass component that defers component updates

Added a tutorial that you can follow to learn how to develop a Greengrass component that defers component updates from deployments. You might want to delay an update when a device has a low battery level or while it runs a process that can't be interrupted, for example.

May 4, 2022

CloudWatch metrics v3.1.0 and Amazon IoT Device Defender v3.1.0 released

CloudWatch metrics component v3.1.0 and Amazon IoT Device Defender component v3.1.0 are available. These releases add support for HTTPS network proxy configurations. For more information, see Connect on port 443 or through a network proxy and Enable the core device to trust an HTTPS proxy.

April 27, 2022

Migrate from Amazon IoT Greengrass Version 1

Added a guide that you can follow to to migrate from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2.

April 26, 2022

Amazon IoT Device Tester v4.5.3 with GGV2Q v2.3.1 updated and IDT v4.5.1 with GGV2Q v2.3.0 added to supported versions

Version 4.5.3 of IDT for Amazon IoT Greengrass V2 with Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.3.1 has been updated to include support for Greengrass nucleus versions 2.5.5, 2.5.4, and 2.5.3. This update also includes IDT 4.5.1 with Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.3.0 as a supported version. IDT 4.5.1 with Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.3.0 supports Greengrass nucleus version 2.5.3.

April 25, 2022

Modbus-RTU protocol adapter v2.1.0 released

Modbus-RTU protocol adapter component v2.1.0 is available. This release adds new parameters that you can specify to configure serial communication with Modbus RTU devices.

April 20, 2022

CloudWatch metrics v2.1.0, Firehose v2.1.0, and Amazon SNS v2.1.0 released

CloudWatch metrics component v2.1.0, Firehose component v2.1.0, and Amazon SNS component v2.1.0 are available. These releases add support for HTTPS network proxy configurations. For more information, see Connect on port 443 or through a network proxy and Enable the core device to trust an HTTPS proxy.

April 19, 2022

Amazon IoT Device Tester v4.5.3 with GGV2Q v2.3.1 released

Version 4.5.3 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.3.1, and supports Greengrass nucleus version 2.5.5.

April 15, 2022

Amazon IoT Greengrass Core v2.5.5 software update

This release provides version 2.5.5 of the Greengrass nucleus component and updates Amazon-provided components. It adds support for Windows devices that use a display language other than English. It also fixes an issue where the core device didn't report its status to the Amazon IoT Greengrass cloud service after provisioning in certain scenarios.

April 6, 2022

Amazon IoT Greengrass Core v2.5.4 software update

This release provides version 2.5.4 of the Greengrass nucleus component and updates Amazon-provided components. It includes bug fixes and improvements.

March 23, 2022

Download Amazon IoT Device Tester programmatically

Added information about how to download IDT for Amazon IoT Greengrass V2 programmatically.

March 15, 2022

Greengrass Development Kit CLI v1.1.0

Version 1.1.0 of the Greengrass Development Kit CLI is available. This version adds new arguments to the component init and component publish commands. This version also updates the component publish command to build the component if it isn't built.

February 24, 2022

Shadow manager v2.1.0 released

Shadow manager component v2.1.0 is available. This release adds the option to configure the interval where the component syncs shadows with Amazon IoT Core. For example, you can specify a longer interval to reduce bandwidth usage and charges.

February 3, 2022

Dockerfile and Docker images for Amazon IoT Greengrass Core software v2.5.3

The Dockerfile and Docker image for Amazon IoT Greengrass Core software v2.5.3 are now available.

January 12, 2022

Amazon IoT Device Tester v4.5.1 with GGV2Q v2.3.0 released

Version 4.5.1 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.3.0, and supports validating and qualifying Linux-based devices that use a hardware security module (HSM) to store the private key and certificate used by Amazon IoT Greengrass Core software.

January 11, 2022

Amazon IoT Greengrass Core v2.5.3 software update

This release provides version 2.5.3 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for you to configure the Amazon IoT Greengrass Core software to use a private key and certificate that you securely store in a hardware security module (HSM).

January 6, 2022

Dockerfile and Docker images for Amazon IoT Greengrass Core software v2.5.2

The Dockerfile and Docker image for Amazon IoT Greengrass Core software v2.5.2 are now available.

December 20, 2021

Amazon IoT Device Tester v4.4.1 with GGV2Q v2.2.1 released

Version 4.4.1 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.2.1, and supports Greengrass nucleus version 2.5.2 for device qualification.

December 12, 2021

Perform machine learning inference using Amazon Lookout for Vision

Added information about how to perform machine learning inference using Lookout for Vision on Greengrass core devices. Lookout for Vision uses computer vision to find visual defects in industrial products.

December 8, 2021

Amazon IoT Device Tester v4.4.1 with GGV2Q v2.2.0 released

Version 4.4.1 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.2.0, and supports Greengrass nucleus version 2.5.2 for device qualification.

December 6, 2021

Amazon IoT Greengrass Core v2.5.2 software update

This release provides version 2.5.2 of the Greengrass nucleus component and updates Amazon-provided components. It fixes an issue with the Windows service that occurs after the Greengrass nucleus updates. It also includes support for the Amazon IoT Device Defender component on Windows devices.

December 3, 2021

New edge connector for Kinesis Video Streams component

Version 1.0.0 of the edge connector for Kinesis Video Streams component is available. This Amazon-provided reads video feeds from local cameras and publishes the streams to Kinesis Video Streams. This component integrates with Amazon IoT TwinMaker, which enables you to view and manage video streams and other data in Grafana dashboards.

November 30, 2021

Manage Greengrass core devices with Amazon Systems Manager

Added information about how to manage Greengrass core devices with Amazon Systems Manager. Systems Manager is an Amazon service that enables you to view operational data, automate operation tasks, and maintain security and compliance.

November 29, 2021

Greengrass Development Kit CLI

Added information about the Amazon IoT Greengrass Development Kit Command-Line Interface (GDK CLI), which is a tool that you can download to your local development computer to help you develop custom Greengrass components. You can use the GDK CLI to create, build, and publish custom components.

November 29, 2021

Community-provided Greengrass components

Added information about the Greengrass Software Catalog, which is an index of Greengrass components that are developed by the Greengrass community. From this catalog, you can download, modify, and deploy components to create your Greengrass applications.

November 29, 2021

Amazon IoT Greengrass Core v2.5.1 software update

This release provides version 2.5.1 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for 32-bit Java on Windows devices. It also fixes issues with the new thing group removal behavior and loading system environment variables on Windows devices.

November 23, 2021

Amazon IoT Device Tester v4.4.0 with GGV2Q v2.1.0 released

Version 4.4.0 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.1.0, and supports qualification of Windows-based Greengrass devices running Greengrass nucleus version 2.5.0.

November 19, 2021

Amazon IoT Greengrass Core v2.5.0 software update

This release provides version 2.5.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for running the Amazon IoT Greengrass Core software on Windows devices. It also changes the thing group removal behavior and adds support for HTTPS proxies.

November 12, 2021

SageMaker Edge Manager v1.1.0 released

Amazon SageMaker Edge Manager component v1.1.0 is available. This release adds support for Greengrass core devices running Amazon Linux 2, and adds a new configuration parameter to specify the location of the capture data folder on your device.

November 3, 2021

Cross-service confused deputy prevention update

Amazon IoT Greengrass V2 supports using the aws:SourceArn and aws:SourceAccount global condition context keys in IAM resource policies to prevent the confused deputy problem.

November 1, 2021

Client device component updates

Client device auth v2.0.3, IP detector v2.1.0, MQTT bridge v2.1.0, and MQTT broker (Moquette) v2.0.2 are available. This release adds full support for non-default MQTT broker ports and includes other bug fixes and improvements.

October 28, 2021

Shadow manager v2.0.4 released

Shadow manager component v2.0.4 is available. This release fixes an issue that caused shadow manager to delete newly created versions of any shadow that was previously deleted. Beginning with this release, the DeleteThingShadow IPC operation increments the shadow version.

October 20, 2021

Log manager v2.2.0 released

Log manager component v2.2.0 is available. Log manager now supports using a configuration map to provide component log configurations.

October 20, 2021

Lambda manager v2.1.4 released

Lambda manager component v2.1.4 is available. This release fixes an issue that caused Lambda functions that use NodeJS runtimes to process only one message.

October 20, 2021

Use interprocess communication, Amazon credentials, and stream manager in Docker container components

Added information about how to use interprocess communication (IPC), Amazon credentials, and stream manager in your custom Docker container components.

October 19, 2021

New nucleus telemetry emitter component

Version 1.0.0 of the nucleus telemetry emitter component is available. This Amazon-provided component gathers system health telemetry data and publishes it continually to a local topic and an Amazon IoT Core MQTT topic.

September 30, 2021

Allow device traffic through a proxy or firewall

Added information about the endpoints and ports that Greengrass core device use, so you can restrict traffic as a security measure.

September 16, 2021

Amazon IoT Device Tester v4.2.0 with GGV2Q v2.0.1 released

Version 4.2.0 of IDT for Amazon IoT Greengrass V2 has been updated with Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.0.1. This release supports Greengrass nucleus version 2.4.0 for device qualification.

August 31, 2021

Updated machine learning installer components

DLR installer component v1.6.5 and TensorFlow Lite installer component v2.5.4 are available. These component versions include the new UseInstaller configuration parameter that lets you disable the default installation script.

August 30, 2021

Embedded Linux support for Amazon IoT Greengrass

The BitBake recipe for Amazon IoT Greengrass V2 is available in the meta-aws project on GitHub. You can use this recipe to build a custom Linux-based operating system using the Yocto Project.

August 20, 2021

Code integrity

Added information about how Amazon IoT Greengrass V2 verifies the integrity of software that Greengrass core devices download from the Amazon Web Services Cloud.

August 19, 2021

VPC endpoints (Amazon PrivateLink)

Amazon IoT Greengrass now supports interface VPC endpoints (Amazon PrivateLink) for the Amazon IoT Greengrass control plane. You can establish a private connection between your VPC and the Amazon IoT Greengrass control plane.

August 16, 2021

Stream manager v2.0.12 released

Stream manager v2.0.12 is now available. This release fixes an issue that prevented upgrades from version 2.0.7 of the stream manager component to a version between v2.0.8 and v2.0.11.

August 10, 2021

Dockerfile and Docker images for Amazon IoT Greengrass Core software v2.4.0

The Dockerfile and Docker image for Amazon IoT Greengrass Core software v2.4.0 are now available.

August 9, 2021

Amazon IoT Greengrass Core v2.4.0 software update

This release provides version 2.4.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for component system resource limits, IPC operations to pause and resume components, and provisioning plugins.

August 3, 2021

New Amazon IoT SiteWise components

Added the following Amazon-provided components for Amazon IoT SiteWise: IoT SiteWise OPC-UA collector, IoT SiteWise publisher, and IoT SiteWise processor.

July 29, 2021

Amazon IoT Device Tester v4.2.0 with GGV2Q v2.0.0 released

Version 4.2.0 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v2.0.0 and includes support for optional qualification tests for Docker components, machine learning, and stream manager.

July 14, 2021

Amazon IoT Greengrass Core IPC library available in Amazon IoT Device SDK for C++ v2

Version 1.13.0 of the Amazon IoT Device SDK for C++ v2 supports Amazon IoT Greengrass Core IPC, so you can develop components in C++ that interact with the Amazon IoT Greengrass Core software.

July 14, 2021

SageMaker Edge Manager component v1.0.2 released

Amazon SageMaker Edge Manager component v1.0.2 is available. This release updates the installation script in the component lifecycle. Your core devices must now have Python 3.6 or later, including pip for your version of Python, installed on the device before you deploy this component.

July 12, 2021

Support update for Amazon IoT Device Tester for Amazon IoT Greengrass V2

IDT for Amazon IoT Greengrass V2 version 4.1.0 now supports using Greengrass nucleus version 2.3.0 for device qualification.

July 8, 2021

Dockerfile and Docker images for Amazon IoT Greengrass Core software v2.3.0

The Dockerfile and Docker image for Amazon IoT Greengrass Core software v2.3.0 are now available.

July 7, 2021

Amazon managed policies

Added information about Amazon managed policies for Amazon IoT Greengrass.

July 2, 2021

New recommended JVM options

Added information about recommended JVM options to control memory allocation for Amazon IoT Greengrass Core software.

June 30, 2021

Amazon IoT Greengrass Core v2.3.0 software update

This release provides version 2.3.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes support for large component configuration documents in deployments.

June 29, 2021

Dockerfile and Docker images for Amazon IoT Greengrass Core software v2.2.0

The Dockerfile and Docker image for Amazon IoT Greengrass Core software v2.2.0 are now available.

June 28, 2021

Amazon IoT Device Tester v4.1.0 with GGV2Q v1.1.1 released

Version 4.1.0 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v1.1.1 and supports using Greengrass nucleus v2.2.0, v2.1.0, and v2.0.5 for device qualification.

June 18, 2021

Amazon IoT Greengrass Core v2.2.0 software update

This release provides version 2.2.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes components that you can deploy to add support for client devices and add the local shadow service.

June 18, 2021

Lambda launcher v2.0.6 released

Version 2.0.6 of the Lambda launcher component is available. This version includes performance improvements and bug fixes.

June 13, 2021

New SageMaker Edge Manager component released

Version 1.0.0 of the Amazon SageMaker Edge Manager component is available for Amazon IoT Greengrass. This component installs the SageMaker Edge Manager agent binary on Greengrass core devices.

June 10, 2021

Component types

Added information about component types in Amazon IoT Greengrass. The component type specifies how the Amazon IoT Greengrass Core software runs a component.

June 3, 2021

Amazon IoT Device Tester v4.0.2 with GGV2Q v1.1.0 released

Version 4.0.2 of IDT for Amazon IoT Greengrass V2 is available. This release includes the Amazon IoT Greengrass V2 qualification suite (GGV2Q) v1.1.0 and supports using Greengrass nucleus v2.1.0 with Greengrass CLI v2.1.0 for device qualification. This also includes new required test groups for MQTT and Lambda, and other minor bug fixes and improvements.

May 5, 2021

Dockerfile and Docker images for Amazon IoT Greengrass Core software v2.1.0

The Dockerfile and Docker image for Amazon IoT Greengrass Core software v2.1.0 are now available. The Docker image enables you to run the Amazon IoT Greengrass Core software in a Docker container that uses Amazon Linux 2 as the base operating system.

April 27, 2021

Amazon IoT Greengrass Core v2.1.0 software update

This release provides version 2.1.0 of the Greengrass nucleus component and updates Amazon-provided components. It includes a new component that you can use to download Docker images from private Amazon ECR repositories, and new sample components to perform machine learning inference using TensorFlow Lite.

April 26, 2021

Example component that uses Secrets Manager

Added an example component that prints the value of an Amazon Secrets Manager secret that you deploy to a core device.

April 8, 2021

Minimal Amazon IoT policy for Greengrass core devices

Added information about the minimal set of permissions required to support basic Greengrass functionality on a core device.

April 2, 2021

Subscribe to IPC event streams

Added information about how to use interprocess communication (IPC) operations to subscribe to streams of events on a Greengrass core device.

April 1, 2021

Support update for Amazon IoT Device Tester for Amazon IoT Greengrass

IDT for Amazon IoT Greengrass V2 version 4.0.1 now supports using Greengrass nucleus version 2.0.5 with Greengrass CLI version 2.0.5 for device qualification.

March 17, 2021

Create custom components that use stream manager

Added information about how to configure component recipes and artifacts to develop applications that manage data streams.

March 9, 2021

Amazon IoT Greengrass Core v2.0.5 software update

This release provides version 2.0.5 of the Greengrass nucleus component and updates Amazon-provided components. It fixes an issue with network proxy support and an issue with the Greengrass data plane endpoint in Amazon China Regions.

March 9, 2021

Component environment variable reference

Added information about the environment variables that the Amazon IoT Greengrass Core software sets for components. You can use these environment variables to get the thing name, Amazon Web Services Region, and Greengrass nucleus version.

February 23, 2021

Manual installation

Added information about how to create required Amazon resources manually or to install behind a firewall or network proxy. By using a manual installation, you don't need to give the installer permission to create resources in your Amazon Web Services account, because you create the the required Amazon IoT and IAM resources. You can also configure your device to connect on port 443 or through a network proxy.

February 17, 2021

Amazon IoT Greengrass Core IPC library update in Amazon IoT Device SDK for Python v2

Version 1.5.4 of the Amazon IoT Device SDK for Python v2 simplifies the steps required to connect to the Amazon IoT Greengrass Core IPC service.

February 11, 2021

Support update for Amazon IoT Device Tester for Amazon IoT Greengrass

IDT for Amazon IoT Greengrass V2 version 4.0.1 now supports using Greengrass nucleus version 2.0.4 with Greengrass CLI version 2.0.4 for device qualification.

February 5, 2021

New tutorial to import Lambda functions

Added a new console-based tutorial to import a Lambda function as a component that runs on Greengrass core device.

February 5, 2021

Amazon IoT Greengrass Core v2.0.4 software update

This release provides version 2.0.4 of the Greengrass nucleus component. It includes the new greengrassDataPlanePort parameter to configure HTTPS communication over port 443 and fixes bugs. The minimal IAM policy now requires the iam:GetPolicy and sts:GetCallerIdentity when the Amazon IoT Greengrass Core software installer is run with --provision true.

February 4, 2021

New secure tunneling component released

Version 1.0.0 of the secure tunneling component is available for Amazon IoT Greengrass. This Amazon-provided component uses Amazon IoT secure tunneling to establish secure bidirectional communication with a Greengrass core device that is behind restricted firewalls.

January 21, 2021

Amazon IoT Device Tester for Amazon IoT Greengrass v4.0.1 released

Version 4.0.1 of IDT for Amazon IoT Greengrass V2 is available. This version enables you to use IDT to develop and run your custom test suites for device validation. This also includes code signed IDT applications for macOS and Windows.

December 22, 2020

Initial release of Amazon IoT Greengrass Version 2

Amazon IoT Greengrass V2 is a new major version release of Amazon IoT Greengrass. This version adds several features such as modular software components and continuous deployments. These features make it easier for you to develop and manage edge applications.

December 15, 2020