AWS IoT Greengrass
Developer Guide

Configure AWS IoT Greengrass on AWS IoT

  1. Sign in to the AWS Management Console on your computer and open the AWS IoT console. If this is the first time opening this console, choose Get started.

  2. Choose Greengrass.

    
                            AWS IoT navigation pane with Greengrass highlighted.
  3. On the Welcome to AWS IoT Greengrass page, choose Create a Group.

    An AWS IoT Greengrass group contains settings and other information about its components, such as devices, Lambda functions, and connectors. A group defines how its components can interact with each other.

    Tip

    For an example that uses the AWS IoT Greengrass API to create and deploy a group, see the gg_group_setup package from GitHub.

  4. On the Set up your Greengrass group page, choose Use easy creation.

    Each group requires an AWS IoT Greengrass core, which manages local processes. A core needs a certificate that allows it to access AWS IoT and an AWS IoT policy that allows it to perform AWS IoT and AWS IoT Greengrass actions. This step creates and provisions a core for the new group.

    
                            Set up your Greengrass Group console page with the Use easy
                                creation button highlighted.
  5. Enter a name for your group (for example, MyFirstGroup), and then choose Next.

    
                            The Name your Group page with MyFirstGroup in the Group Name
                                field and the Next button highlighted.
  6. Use the default name for the AWS IoT Greengrass core, and then choose Next.

    
                            The Every Group needs a Core to function page with
                                MyFirstGroup_Core in the Name field and the Next button
                                highlighted.
  7. On the Run a scripted easy Group creation page, choose Create Group and Core.

    
                            The Run a scripted easy Group creation page with the Create
                                Group and Core button highlighted.

    AWS IoT creates an AWS IoT Greengrass group with default security policies and configuration files for you to load onto your device.

  8. On the confirmation page, download your core's security resources and the AWS IoT Greengrass core software:

    Note

    You can alternatively download the core software from the AWS IoT Greengrass Core Software downloads.

    1. Under Download and store your Core's security resources, choose Download these resources as a tar.gz to download the required security resources for your AWS IoT Greengrass core.

      
                                    The Connect your Core device page with Download these resources
                                        as a tar.gz highlighted.
    2. Under Software configurations, choose the CPU architecture and distribution (and operating system, if necessary) that best describes your core device. For example:

      • For Raspberry Pi, download the ARMv7l for Raspbian package.

      • For an Amazon EC2 instance, download the x86_64 for Linux package.

      • For NVIDIA Jetson TX2, download the ARMv8 (AArch64) for Ubuntu package.

      • For Intel Atom, download the x86_64 for Linux package.

      
                                    The Connect your Core device page with Download
                                        highlighted.

    Important

    Download both the security resources and core software before you choose Finish.

  9. After you have downloaded the security resources and the AWS IoT Greengrass Core software, choose Finish.

    The group configuration page is displayed in the console:

    
                            Empty group configuration page.