Migrate from Amazon IoT Greengrass Version 1 - Amazon IoT Greengrass
Migration overview
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).

Migrate from Amazon IoT Greengrass Version 1

Amazon IoT Greengrass Version 2 is a major version release of the Amazon IoT Greengrass Core software, APIs, and console. Amazon IoT Greengrass V2 introduces several improvements to Amazon IoT Greengrass V1, such as modular applications, deployments to large fleets of devices, and support for additional platforms.

Note

End of support notice: On October 1, 2026, Amazon will end support for Amazon IoT Greengrass Version 1. After October 1, 2026, you will no longer be able to access the Amazon IoT Greengrass V1 console or Amazon IoT Greengrass V1 resources.

Follow instructions in this guide to migrate from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2.

Migration overview

At a high level, you can use the following procedure to upgrade core devices from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2.

Before migrating, you'll choose between two runtime options:

  • Greengrass nucleus (lower migration effort, full feature support)

  • Greengrass nucleus lite (higher migration effort, designed for resource-constrained devices).

The exact procedure that you follow depends on your device resources, required features, and specific environment requirements.

An overview of how to migrate from Amazon IoT Greengrass V1 to Amazon IoT Greengrass V2.
  1. Understand the differences between V1 and V2

    Amazon IoT Greengrass V2 introduces new fundamental concepts for device fleets and deployable software, and V2 simplifies several concepts from V1.

    The Amazon IoT Greengrass V2 cloud service and Amazon IoT Greengrass Core software v2.x aren't backward compatible with the Amazon IoT Greengrass V1 cloud service and Amazon IoT Greengrass Core software v1.x. As a result, Amazon IoT Greengrass V1 over-the-air (OTA) updates can't upgrade core devices from V1 to V2.

  2. Choose your runtime (Greengrass nucleus or Greengrass nucleus lite)

    Decide between Greengrass nucleus or Greengrass nucleus lite based on your device resources and feature requirements:

    • Greengrass nucleus path: Lower migration effort. Lambda functions can be imported as Lambda components with minimal code changes. Supports V1 features (local shadow service, client devices, connectors).

    • Greengrass nucleus lite path: Higher migration effort. Lambda functions need to be converted to generic components, requiring code changes to use Amazon IoT Device SDK V2/Amazon IoT Greengrass Component SDK instead of Amazon IoT Greengrass Core SDK. Does not support local shadow service, client devices, or connectors.

  3. Set up a new device to test V1 applications on V2

    To minimize risk to your devices in production, create a new device to test your V1 applications on V2. Choose the setup guide based on your runtime selection:

  4. Upgrade V1 core devices to run V2

    After testing on a new device, upgrade your existing V1 core devices to run the Amazon IoT Greengrass Core software v2.x and Amazon IoT Greengrass V2 components. To migrate a fleet of devices from V1 to V2, you repeat this step for each device in the fleet.