Amazon IoT Greengrass Version 1 maintenance policy - 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.

Amazon IoT Greengrass Version 1 no longer receives feature updates, and will receive only security patches and bug fixes until June 30, 2023. For more information, see the Amazon IoT Greengrass V1 maintenance policy. We strongly recommend that you migrate to Amazon IoT Greengrass Version 2, which adds significant new features and support for additional platforms.

Amazon IoT Greengrass Version 1 maintenance policy

Use this Amazon IoT Greengrass V1 maintenance policy to understand the different levels of maintenance and updates for the Amazon IoT Greengrass V1 service and the Amazon IoT Greengrass Core software v1.x.

Amazon IoT Greengrass versioning scheme

Amazon IoT Greengrass uses semantic versioning for the Amazon IoT Greengrass Core software. Semantic versions follow a major.minor.patch number system. The major version increments for functional and API changes that aren't backward-compatible with previous major versions. The minor version increments for releases that add new backward-compatible functionality. The patch version increments for security patches or bug fixes. Since its first major release, v1.0.0, Amazon IoT Greengrass has released 11 minor versions of the Amazon IoT Greengrass Core software v1.x, where v1.11.6 is the latest release. We recommend that you update your Amazon IoT Greengrass Core software to the latest available version to take advantage of new features, enhancements, and bug fixes.

In December 2020, Amazon IoT Greengrass released its first major version update. This update included the Amazon IoT Greengrass V2 service and version 2.0.3 of the Amazon IoT Greengrass Core software. For new applications, we strongly recommend that you use Amazon IoT Greengrass Version 2 and the Amazon IoT Greengrass Core software v2.x. Version 2 receives new features, includes all key V1 features, and supports additional platforms and continuous deployments to large fleets of devices. For more information, see What is Amazon IoT Greengrass V2?.

Lifecycle phases for major versions of the Amazon IoT Greengrass Core software

Each major version of the Amazon IoT Greengrass Core software has the following three sequential lifecycle phases. Each lifecycle phase provides different levels of maintenance over a period of time after the initial release date.

  • Release phase – Amazon IoT Greengrass may release the following updates:

    • Minor version updates that provide new features or enhancements to existing features

    • Patch version updates that provide security patches and bug fixes

  • Maintenance phase – Amazon IoT Greengrass may release patch version updates that provide security patches and bug fixes. Amazon IoT Greengrass won't release new features or enhancements to existing features during the maintenance phase.

  • Extended life phase – Amazon IoT Greengrass won't release updates that provide features, enhancements to existing features, security patches, or bug fixes. However, the Amazon Web Services Cloud endpoints and API operations will remain available and operate according to the Amazon IoT Greengrass Service Level Agreement. Devices that run the Amazon IoT Greengrass Core software v1.x can continue to connect to the Amazon Web Services Cloud and operate.

After the extended life phase ends for a major version of Amazon IoT Greengrass, the Amazon Web Services Cloud endpoints and API operations will be deprecated and no longer available. Devices that run the Amazon IoT Greengrass Core software v1.x won't be able to connect to Amazon Web Services Cloud services to operate.

Maintenance policy for Amazon IoT Greengrass Core software

The Amazon IoT Greengrass Core software v1.x is currently in the maintenance phase until June 30, 2023. On this date, the Amazon IoT Greengrass Core software v1.x enters the extended life phase, and it will remain in the extended life phase until further notice.

The Amazon IoT Greengrass Core software v2.x is currently in the release phase, and it will remain in the release phase until further notice. Amazon IoT Greengrass continues to add new features and enhancements to the Amazon IoT Greengrass Core software v2.x. For example, Amazon IoT Greengrass released Windows support in v2.5.0 of the Amazon IoT Greengrass Core software. Amazon IoT Greengrass releases security patches and bug fixes for all minor versions of Amazon IoT Greengrass Core v2.x for at least 1 year after the release date. For more information, see What's new in Amazon IoT Greengrass V2.

Maintenance phase schedule

On June 30, 2023, the maintenance phase ends for the Amazon IoT Greengrass Core software v1.11.x. On March 31, 2022, the maintenance phase ended for the Amazon IoT Greengrass Core software v1.10.x. The maintenance phase ends for certain Amazon IoT Greengrass Core software v1.x artifacts and features earlier than these dates. For more information, see End of maintenance schedule. During the maintenance phase, Amazon IoT Greengrass won't add new features or enhancements to the Amazon IoT Greengrass Core software v1.x.

If you have an Amazon Web Services Support plan, the maintenance phase for Amazon IoT Greengrass Core software v1.x doesn't affect your Amazon Web Services Support plan. You can continue to open Amazon Web Services Support tickets even after the maintenance phase ends. If you have questions or concerns, contact your Amazon Web Services Support contact, or ask a question on Amazon re:Post using the Amazon IoT Greengrass tag.

Deprecation schedule

Currently, there is no plan to stop supporting the Amazon IoT Greengrass Core software v1.x. The Amazon IoT Greengrass V1 endpoints and API operations will remain available until further notice. After the maintenance phase ends on June 30, 2023, the Amazon IoT Greengrass Core software v1.11.6 will enter the extended life phase until further notice. During this phase, devices that run the Amazon IoT Greengrass Core software v1.x can continue to connect to the Amazon IoT Greengrass V1 service to operate until further notice.

If Amazon IoT Greengrass V1 stops being supported in the future, Amazon IoT Greengrass will provide 12 months advance notice before this happens. This will help you plan the update of your applications to use Amazon IoT Greengrass V2 and the Amazon IoT Greengrass Core software v2.x. For more information about how to update your applications to V2, see Move from Amazon IoT Greengrass V1 to V2.

Support policy for Amazon Lambda functions on Greengrass core devices

Amazon IoT Greengrass enables you to run Amazon Lambda functions on IoT devices. Amazon Lambda provides a support policy and timelines that determine support for Lambda runtimes in Amazon IoT Greengrass. After a Lambda runtime reaches the end of support phase, Amazon IoT Greengrass also ends support for that runtime. For more information, see Runtime support policy in the Amazon Lambda Developer Guide.

When a Lambda runtime reaches end of support, you can't create or update Lambda functions that use that runtime. However, you can continue to deploy these Lambda functions to Greengrass core devices and invoke deployed Lambda functions. This policy also applies to Amazon IoT Greengrass V2.

Support policy for Amazon IoT Device Tester for Amazon IoT Greengrass V1

Amazon IoT Device Tester (IDT) for Amazon IoT Greengrass V1 enables you to validate and qualify your Amazon IoT Greengrass devices for inclusion in the Amazon Partner Device Catalog. As of April 4, 2022, Amazon IoT Device Tester (IDT) for Amazon IoT Greengrass V1 no longer generates signed qualification reports. You can no longer qualify new Amazon IoT Greengrass V1 devices to list in the Amazon Partner Device Catalog through the Amazon Device Qualification Program. While you can't qualify Greengrass V1 devices, you can continue to use IDT for Amazon IoT Greengrass V1 to test your Greengrass V1 devices. We recommend that you use IDT for Amazon IoT Greengrass V2 to qualify and list Greengrass devices in the Amazon Partner Device Catalog. For more information, see Support policy for Amazon IoT Device Tester for Amazon IoT Greengrass V1.

End of maintenance schedule

The following table lists end of maintenance dates for Amazon IoT Greengrass Core v1.x artifacts and features. If you have questions about the maintenance schedule or policy, contact Amazon Support.

Artifact or feature End of maintenance date

Greengrass APT repository installation

February 11, 2022

ML Image Classification connector

March 31, 2022

ML Object Detection connector

March 31, 2022

ML Feedback connector

March 31, 2022

Amazon IoT Analytics connector

March 31, 2022

Twilio Notifications connector

March 31, 2022

Splunk Integration connector

March 31, 2022

Serial Stream connector

March 31, 2022

ServiceNow MetricBase Integration connector

March 31, 2022

Raspberry Pi GPIO connector

March 31, 2022

Amazon IoT Greengrass Core software v1.10.x

March 31, 2022

Amazon IoT Greengrass Core software v1.x Docker images

June 30, 2022

Amazon IoT Greengrass Core software v1.11.x

June 30, 2023

End of maintenance for Amazon IoT Greengrass Core software v1.x Docker images

On June 30, 2022, Amazon IoT Greengrass ended maintenance for Amazon IoT Greengrass Core software v1.x Docker images that are published to Amazon Elastic Container Registry (Amazon ECR) and Docker Hub. You can continue to download these Docker images from Amazon ECR and Docker Hub until June 30, 2023, which is 1 year after maintenance ended. However, the Amazon IoT Greengrass Core software v1.x Docker images no longer receive security patches or bug fixes after maintenance ended on June 30, 2022. If you run a production workload that depends on these Docker images, we recommend that you build your own Docker images using the Dockerfiles that Amazon IoT Greengrass provides. For more information, see Amazon IoT Greengrass Docker software.

End of maintenance for Amazon IoT Greengrass Core software v1.x APT repository

On February 11, 2022, Amazon IoT Greengrass ended maintenance for the option to install the Amazon IoT Greengrass Core software v1.x from an APT repository. The APT repository was removed on this date, so you can no longer to use the APT repository to update the Amazon IoT Greengrass Core software or install the Amazon IoT Greengrass Core software on new devices. On devices where you added the Amazon IoT Greengrass repository, you must remove the repository from the sources list. We recommend that you update the Amazon IoT Greengrass Core software v1.x using tar files.