Document history for Amazon IoT Greengrass - 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).

Amazon IoT Greengrass Version 1 entered the extended life phase on June 30, 2023. For more information, see the Amazon IoT Greengrass V1 maintenance policy. After this date, Amazon IoT Greengrass V1 won't release updates that provide features, enhancements, bug fixes, or security patches. Devices that run on Amazon IoT Greengrass V1 won't be disrupted and will continue to operate and to connect to the cloud. We strongly recommend that you migrate to Amazon IoT Greengrass Version 2, which adds significant new features and support for additional platforms.

Document history for Amazon IoT Greengrass

The following table describes important changes to the Amazon IoT Greengrass Developer Guide after June 2018. For notification about updates to this documentation, you can subscribe to an RSS feed.

ChangeDescriptionDate

Update to end of support for v1.11.x Snap

Updated the end of support information for Amazon IoT Greengrass core v 1.11.x Snap on snapcraft.io .

September 22, 2023

End of support for v1.11.x Snap

Added end of support information for Amazon IoT Greengrass core v 1.11.x Snap on snapcraft.io .

September 19, 2023

Docker images for Amazon IoT Greengrass v1.11.6

The Docker images for Amazon IoT Greengrass Core software v1.11.6 are available on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub. We recommend that you always run the latest version.

April 12, 2022

Amazon IoT Device Tester (IDT) for Amazon IoT Greengrass V1 deprecation

IDT for Amazon IoT Greengrass V1 will no longer generate signed qualification reports.

April 4, 2022

Support update for Amazon IoT Device Tester for Amazon IoT Greengrass

IDT for Amazon IoT Greengrass version 4.4.1 now supports using Amazon IoT Greengrass core software version v1.11.6 for device qualification.

March 24, 2022

Amazon IoT Greengrass version 1.11.6 released

Version 1.11.6 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. We recommend that you always run the latest version.

March 24, 2022

IoT SiteWise connector version 12 released

Version 12 of the IoT SiteWise connector is available. This release contains bug fixes.

December 23, 2021

Docker images for Amazon IoT Greengrass v1.11.5 and v1.10.5

The Docker images for Amazon IoT Greengrass Core software v1.11.5 and v1.10.5 are available on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub. We recommend that you always run the latest version.

December 22, 2021

Amazon IoT Greengrass V1 maintenance policy

The Amazon IoT Greengrass V1 maintenance policy defines the different levels of maintenance and updates for the Amazon IoT Greengrass V1 service and the Amazon IoT Greengrass core software v1.x.

December 20, 2021

Amazon IoT Device Tester version 4.4.1 released

IDT for Amazon IoT Greengrass version 4.4.1 is now available. This release includes the Amazon IoT Greengrass qualification suite (GGQ) v1.3.1, and supports using Amazon IoT Greengrass core software versions v1.11.5 and v1.10.5 for device qualification.

December 20, 2021

Amazon IoT Greengrass versions 1.11.5 and 1.10.5 released

Versions 1.11.5 and 1.10.5 of the Amazon IoT Greengrass Core software are available. These versions contain performance improvements and bug fixes. We recommend that you always run the latest version.

December 12, 2021

Republished Amazon IoT Greengrass v1.11.4 and v1.10.4 Docker images

Docker images for Amazon IoT Greengrass Core software versions 1.11.4 and 1.10.4 have been republished on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub to address bug fixes with BusyBox. To use the latest Docker images, use the 1.11.4-1 or 1.10.4-1 tags. For more information about available tags, see amazon/aws-iot-greengrass in Docker Hub.

December 8, 2021

CloudWatch Metrics connector supports duplicate timestamps in input data

You can now send input data with duplicate timestamps to this connector.

November 19, 2021

Cross-service confused deputy prevention update

Amazon IoT Greengrass 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

Docker images for Amazon IoT Greengrass v1.11.4

The Docker images for Amazon IoT Greengrass Core software v1.11.4 are available on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub. We recommend that you always run the latest version.

August 24, 2021

Published Amazon IoT Greengrass v1.11.4 snap

Version 1.11.4 of the Amazon IoT Greengrass snap is available. We recommend that you always run the latest version.

August 20, 2021

Support update for Amazon IoT Device Tester for Amazon IoT Greengrass

IDT for Amazon IoT Greengrass version 4.1.0 now supports using Amazon IoT Greengrass core software version v1.11.4 for device qualification.

August 18, 2021

Amazon IoT Greengrass version 1.11.4 released

Version 1.11.4 of the Amazon IoT Greengrass Core software is available. This release fixes an issue with stream manager that prevented upgrades to v1.11.3 from an earlier version of the Amazon IoT Greengrass Core software. We recommend that you always run the latest version.

August 17, 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

Amazon IoT Device Tester version 4.1.0 released

Version 4.1.0 of Amazon IoT Device Tester for Amazon IoT Greengrass is available. This version supports using Amazon IoT Greengrass core software versions 1.11.3 and 1.10.4 for device qualification.

June 23, 2021

Published Amazon IoT Greengrass v1.11.3 snap

Version 1.11.3 of the Amazon IoT Greengrass snap contains performance improvements and bug fixes. We recommend that as a best practice you always run the latest version.

June 15, 2021

Docker images for Amazon IoT Greengrass v1.11.3 and v1.10.4 released

The Docker images for Amazon IoT Greengrass Core software v1.11.3 and v1.10.4 are available on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub. These versions of Amazon IoT Greengrass Core contain performance improvements and bug fixes. We recommend that you always run the latest version.

June 15, 2021

Amazon IoT Greengrass version 1.11.3 released

Version 1.11.3 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. We recommend that you always run the latest version.

June 14, 2021

Amazon IoT Greengrass version 1.10.4 released

Version 1.10.4 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. We recommend that you always run the latest version.

June 14, 2021

Modbus-TCP Protocol Adapter version 2 released

Version 2 of the Modbus-TCP Protocol Adapter connector is available. This release added support for ASCII, UTF8, and ISO8859 encoded source strings.

May 24, 2021

Docker application deployment connector version 7 released

Version 7 of the Greengrass Docker application deployment connector is available.

April 5, 2021

Amazon IoT Greengrass version 1.11.1 released

Version 1.11.1 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. We recommend that you always run the latest version.

March 29, 2021

Amazon IoT Device Tester version 4.0.2 released

Version 4.0.2 of Amazon IoT Device Tester for Amazon IoT Greengrass is available. This version replaces IDT v4.0.0 and adds support for version 1.11.1 of Amazon IoT Greengrass Core software. This also fixes an issue that caused IDT to mask Hardware Security Integration (HSI) errors.

March 29, 2021

IoT SiteWise connector version 11 released

Version 11 of the IoT SiteWise connector is available. This launches support for strings that contain hidden or unprintable characters. This release also includes general performance improvements and bug fixes.

March 24, 2021

Republished Amazon IoT Greengrass v1.11.0 snap

Amazon IoT Greengrass snap version 1.11.0 has been republished on Snapcraft to address bug fixes and a possible application crash when using the Python interpreter. Amazon IoT Greengrass doesn’t provide snaps for software versions 1.10 and 1.9.

March 19, 2021

Support update for Amazon IoT Device Tester for Amazon IoT Greengrass

IDT for Amazon IoT Greengrass version 4.0.0 now supports using Amazon IoT Greengrass core software version v1.10.3 for device qualification.

March 18, 2021

Republished Amazon IoT Greengrass v1.8.4 snap

Amazon IoT Greengrass snap version 1.8.4 has been republished on Snapcraft to address bug fixes and a possible application crash when using the Python interpreter.

March 15, 2021

Republished Amazon IoT Greengrass v1.11.0 Docker image for Armv7l

The Docker image for Amazon IoT Greengrass Core software version 1.11.0 for the Armv7l platform has been republished on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub to address bug fixes and a possible application crash when using the Python interpreter.

March 8, 2021

Amazon IoT Greengrass v1.10.3 Docker images released

Docker images for Amazon IoT Greengrass Core software version 1.10.3 are now available on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub.

March 8, 2021

Republished Amazon IoT Greengrass v1.11.0 and v1.9.4 Docker images

Docker images for Amazon IoT Greengrass Core software versions 1.11.0 and 1.9.4 have been republished on Amazon Elastic Container Registry (Amazon ECR) and Docker Hub to address bug fixes and a possible application crash when using the Python interpreter. The Docker images for Armv7l have not been republished at this time.

February 26, 2021

Amazon IoT Greengrass version 1.10.3 released

Version 1.10.3 of the Amazon IoT Greengrass Core software is available. This version adds the systemComponentAuthTimeout core configuration property and contains performance improvements and bug fixes. We recommend that you always run the latest version.

February 24, 2021

IoT SiteWise connector version 10 released

Version 10 of the IoT SiteWise connector is available. This release resolves stability issues with the StreamManager client when connection is lost, and improves OPC-UA value handling when a SourceTimestamp is absent. Use the IoT SiteWise connector to send local device and equipment data to asset properties in IoT SiteWise.

January 22, 2021

IoT SiteWise connector version 9 released

Version 9 of the IoT SiteWise connector is available. This launches support for custom Greengrass StreamManager stream destinations, OPC-UA deadbanding, custom scan mode and custom scan rate. This also includes improved performance during configuration updates made from the IoT SiteWise gateway. Use the IoT SiteWise connector to send local device and equipment data to asset properties in IoT SiteWise.

December 15, 2020

Amazon IoT Device Tester version 4.0.0 released

Version 4.0.0 of Amazon IoT Device Tester for Amazon IoT Greengrass 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 15, 2020

Amazon IoT Greengrass snap v1.11

Version 1.11.0 of the Amazon IoT Greengrass snap supports noncontainerized Lambda functions. We recommend that as a best practice you always run the latest version.

December 6, 2020

IoT SiteWise connector version 8 released

Version 8 of the IoT SiteWise connector is available. This release improves stability when the connector experiences intermittent network connectivity. Use the IoT SiteWise connector to send local device and equipment data to asset properties in IoT SiteWise.

November 19, 2020

Kinesis Firehose connector supports No container mode

You can use the IsolationMode parameter to configure the containerization mode for the connector.

October 19, 2020

Docker application deployment connector version 6 released

Version 6 of the Greengrass Docker application deployment connector is available.

September 18, 2020

Amazon IoT Greengrass version 1.11.0 released

Version 1.11.0 of the Amazon IoT Greengrass Core software is available. This version adds the system health telemetry feature and a local health check API. Stream manager can now export data to Amazon Simple Storage Service (Amazon S3) and IoT SiteWise. This version also contains performance improvements and bug fixes. We recommend that you always run the latest version.

September 16, 2020

IoT SiteWise connector version 7 released

Version 7 of the IoT SiteWise connector is available. This release fixes an issue with gateway metrics. Use the IoT SiteWise connector to send local device and equipment data to asset properties in IoT SiteWise.

August 14, 2020

ServiceNow MetricBase Integration, Splunk Integration, and Twilio Notifications connectors support No container mode

You can use the IsolationMode parameter to configure the containerization mode for the connector.

July 30, 2020

SNS connector supports No container mode

You can use the IsolationMode parameter to configure the containerization mode for the connector.

July 6, 2020

CloudWatch Metrics connector supports No container mode

You can use the IsolationMode parameter to configure the containerization mode for the connector.

June 17, 2020

Amazon IoT Greengrass version 1.10.2 released

Version 1.10.2 of the Amazon IoT Greengrass Core software is available. This version adds the mqttOperationTimeout core configuration property and contains performance improvements and bug fixes. We recommend that you always run the latest version.

June 8, 2020

Tensorflow machine learning installers deprecated

Amazon IoT Greengrass Tensorflow prepackaged machine learning installers have been deprecated. Machine learning samples have been upgraded to Python 3.7.

May 29, 2020

Chainer framework support and Greengrass machine learning installers deprecated

Amazon IoT Greengrass prepackaged machine learning installers and downloads for MXNet and DLR have been deprecated. Chainer framework support and associated downloads have been deprecated.

May 4, 2020

IoT SiteWise connector version 6 released

Version 6 of the IoT SiteWise connector is available. This release adds support for CloudWatch metrics and automatic discovery of new OPC-UA tags. This means you don't need to restart your gateway when tags change for your OPC-UA sources. This version of the connector requires stream manager and Amazon IoT Greengrass Core software v1.10.0 or higher. Use the IoT SiteWise connector to send local device and equipment data to asset properties in IoT SiteWise.

April 29, 2020

Connectors upgraded to Python 3.7

Connectors that support the Python runtime have been upgraded to Python 3.7. We recommend that you upgrade your connector versions from Python 2.7 to Python 3.7.

April 29, 2020

Greengrass device setup can run in silent mode

You can run Greengrass device setup in silent mode so that the script doesn't prompt you for any values.

April 27, 2020

New Docker base images

You can download Amazon IoT Greengrass Docker images that are built on Alpine Linux (x86_64, Armv7l, or AArch64) base images.

April 23, 2020

Amazon IoT Greengrass version 1.10.1 released

Version 1.10.1 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. We recommend that you always run the latest version.

April 16, 2020

New security chapter

Amazon IoT Greengrass security content has been reorganized, with new information added.

March 30, 2020

Use APT package manager to install Amazon IoT Greengrass

On supported Debian-based Linux distributions, you can use apt to install the Amazon IoT Greengrass Core software on your devices.

February 26, 2020

IoT SiteWise connector version 5 released

Version 5 of the IoT SiteWise connector is available. This release fixes a compatibility issue with Amazon IoT Greengrass Core software v1.9.4. Use the IoT SiteWise connector to send local device and equipment data to asset properties in IoT SiteWise.

February 12, 2020

New script to quickly set up a core device

You can use Greengrass device setup to configure your core device in minutes. Also, Amazon IoT Greengrass now supports Node.js 12.x Lambda functions.

December 20, 2019

Amazon IoT Greengrass version 1.10.0 released

Version 1.10.0 of the Amazon IoT Greengrass Core software is available. The new features in this version include Stream manager, container support with the Docker application deployment connector, non-containerized Lambda functions that can access machine learning resources, support for MQTT persistent sessions with Amazon IoT, and support for local MQTT traffic over a specified port.

November 25, 2019

Console support for deployment notifications

Use the Amazon EventBridge console to create event rules that trigger when your Greengrass group deployments change state.

November 14, 2019

Amazon IoT Greengrass version 1.9.4 released

Version 1.9.4 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. As a best practice, we recommend that you always run the latest version.

October 17, 2019

Console support for managing the Greengrass service role

Use new and improved features in the Amazon IoT console to manage your Greengrass service role.

October 4, 2019

Console support for managing group-level tags

You can create, view, and manage tags for your Greengrass groups in the Amazon IoT console.

September 23, 2019

New machine learning connectors

Use the ML Feedback connector to publish model input and predictions and the ML Object Detection connector to run a local object detection inference service.

September 19, 2019

Amazon IoT Greengrass version 1.9.3 released

Version 1.9.3 of the Amazon IoT Greengrass Core software is available. This version allows you to install the Amazon IoT Greengrass Core software on Raspbian distributions on Armv6l architectures, supports OTA updates on port 443 with ALPN, and contains a bug fix for binary payloads sent from Python 2.7 Lambda functions to other Lambda functions.

September 12, 2019

Amazon IoT Greengrass version 1.8.4 released

Version 1.8.4 of the Amazon IoT Greengrass Core software is available. This version contains performance improvements and bug fixes. If you're running v1.8.x, we recommend that you upgrade to v1.8.4 or v1.9.3. For earlier versions, we recommend that you upgrade to v1.9.3.

August 30, 2019

Amazon IoT Greengrass version 1.9.2 released with support for OpenWrt

Version 1.9.2 of the Amazon IoT Greengrass Core software is available. This version allows you to install the Amazon IoT Greengrass Core software on OpenWrt distributions with Armv8 (AArch64) and Armv7l architectures.

June 20, 2019

Amazon IoT Greengrass version 1.8.3 released

Version 1.8.3 of the Amazon IoT Greengrass Core software is available. This version contains general performance improvements and bug fixes. If you're running v1.8.x, we recommend that you upgrade to v1.8.3 or v1.9.2. For earlier versions, we recommend that you upgrade to v1.9.2.

June 20, 2019

Amazon IoT Greengrass version 1.9.1 released

Version 1.9.1 of the Amazon IoT Greengrass Core software is available. This version contains a bug fix for messages from Amazon IoT that contain a wildcard character in the topic.

May 10, 2019

Amazon IoT Greengrass version 1.8.2 released

Version 1.8.2 of the Amazon IoT Greengrass Core software is available. This version contains general performance improvements and bug fixes. If you're running v1.8.x, we recommend that you upgrade to v1.8.2 or v1.9.0. For earlier versions, we recommend that you upgrade to v1.9.0.

May 2, 2019

Amazon IoT Greengrass version 1.9.0 released

New features: Support for Python 3.7 and Node.js 8.10 Lambda runtimes, optimized MQTT connections, and Elliptic Curve (EC) key support for the local MQTT server.

May 1, 2019

Amazon IoT Greengrass version 1.8.1 released

Version 1.8.1 of the Amazon IoT Greengrass Core software is available. This version contains general performance improvements and bug fixes. As a best practice, we recommend that you always run the latest version.

April 18, 2019

Amazon IoT Greengrass snap available on snapcraft

Use the Amazon IoT Greengrass Snap Store app to quickly design, test, and deploy software on Linux devices with Amazon IoT Greengrass.

April 1, 2019

Support for more access control using tag-based permissions

You can use tags in Amazon Identity and Access Management (IAM) policies to control access to your Amazon IoT Greengrass resources.

March 29, 2019

IoT Analytics connector released

Use the IoT Analytics connector to send local device data to Amazon IoT Analytics channels.

March 15, 2019

Batch support in Kinesis Firehose connector

The Kinesis Firehose connector supports sending batched data records to Amazon Data Firehose at a specified interval.

March 15, 2019

Amazon CloudFormation support for Amazon IoT Greengrass resources

Use Amazon CloudFormation templates to create and manage Amazon IoT Greengrass resources.

March 15, 2019

Amazon IoT Greengrass version 1.8.0 released

New features: Configurable default access identity for Lambda functions, support for HTTPS traffic over port 443, and predictably named client IDs for MQTT connections with Amazon IoT.

March 7, 2019

Amazon IoT Greengrass versions 1.7.1 and 1.6.1 released

Versions 1.7.1 and 1.6.1 of the Amazon IoT Greengrass Core software are available. These versions require Linux kernel version 3.17 or later. We recommend that customers running any version of the Greengrass core software upgrade to version 1.7.1 immediately.

February 11, 2019

SageMaker Neo deep learning runtime

The SageMaker Neo deep learning runtime supports machine learning models that have been optimized by the SageMaker Neo deep learning compiler.

November 28, 2018

Run Amazon IoT Greengrass in a Docker container

You can run Amazon IoT Greengrass in a Docker container by configuring your Greengrass group to run with no containerization.

November 26, 2018

Amazon IoT Greengrass version 1.7.0 released

New features: Greengrass connectors, local secrets manager, isolation and permission settings for Lambda functions, hardware root of trust security, connection using ALPN or network proxy, and Raspbian Stretch support.

November 26, 2018

Amazon IoT Greengrass software downloads

The Amazon IoT Greengrass Core software, Amazon IoT Greengrass Core SDK, and Amazon IoT Greengrass Machine Learning SDK packages are available for dowload through Amazon CloudFront.

November 26, 2018

Amazon IoT Device Tester for Amazon IoT Greengrass

Use Amazon IoT Device Tester for Amazon IoT Greengrass to verify that your CPU architecture, kernel configuration, and drivers work with Amazon IoT Greengrass.

November 26, 2018

Amazon CloudTrail logging for Amazon IoT Greengrass API calls

Amazon IoT Greengrass is integrated with Amazon CloudTrail, a service that provides a record of actions taken by a user, role, or an Amazon service in Amazon IoT Greengrass.

October 29, 2018

Support for TensorFlow v1.10.1 on NVIDIA Jetson TX2

The TensorFlow precompiled library for NVIDIA Jetson TX2 that Amazon IoT Greengrass provides now uses TensorFlow v1.10.1. This supports Jetpack 3.3 and CUDA Toolkit 9.0.

October 18, 2018

Support for MXNet v1.2.1 machine learning resources

Amazon IoT Greengrass supports machine learning models that are trained using MXNet v1.2.1.

August 29, 2018

Amazon IoT Greengrass version 1.6.0 released

New features: Lambda executables, configurable message queue, configurable reconnect retry interval, volume resources under /proc, and configurable write directory.

July 26, 2018

Earlier updates

The following table describes important changes to the Amazon IoT Greengrass Developer Guide before July 2018.

Change Description Date
Amazon IoT Greengrass Version 1.5.0 Released

New features:

  • Local machine learning inference using cloud-trained models. For more information, see Perform machine learning inference.

  • Greengrass Lambda functions support binary input data, in addition to JSON.

For more information, see Amazon IoT Greengrass Core versions.

March 29, 2018
Amazon IoT Greengrass Version 1.3.0 Released

New features:

November 27, 2017
Amazon IoT Greengrass Version 1.1.0 Released

New features:

  • Reset deployed Amazon IoT Greengrass groups. For more information, see Reset deployments.

  • Support for Node.js 6.10 and Java 8 Lambda runtimes, in addition to Python 2.7.

September 20, 2017
Amazon IoT Greengrass Version 1.0.0 Released

Amazon IoT Greengrass is generally available.

June 7, 2017