AWS Greengrass
Developer Guide

Getting Started with AWS Greengrass

This tutorial includes six modules, each designed to show you AWS Greengrass basics and help you get started in as few steps as possible. This tutorial covers:

  • The AWS Greengrass programming model.

  • Fundamental concepts, such as AWS Greengrass cores, groups, and subscriptions.

  • The deployment process for running AWS Lambda functions at the edge.


To complete this tutorial, you will need the following:

  • A Mac, Windows PC, or UNIX-like system.

  • An Amazon Web Services (AWS) account. If you don’t have an AWS account, see Create an AWS Account.

  • The use of an AWS region that supports AWS Greengrass. For the list of supported regions for AWS Greengrass, see AWS Regions and Endpoints in the AWS General Reference.


    Make note of your region to ensure that it is consistently used throughout this tutorial – inadvertently switching regions midway through the tutorial would be problematic. Note that the last exercise in this tutorial assumes the US East (N. Virgina) region, so you may want to only use the US East (N. Virgina) region, as possible.

  • A Raspberry Pi 3 Model B with a 8 GB microSD card, or an Amazon EC2 instance. Because AWS Greengrass is intended to be used with physical hardware, we recommend that you use a Raspberry Pi.


    If the model of your Raspberry Pi is unknown, you can run the following command:

    cat /proc/cpuinfo

    Near the bottom of the listing, note the value of the Revision attribute. You can determine the model of your Pi by using this value along with the table at Which Pi have I got? For example, if the value of Revision is a02082, then from the table we see that the Pi is a 3 Model B. Additionally, the architecture of your Pi must be armv71 or greater. To determine the architecture of your Raspberry Pi, run the following command:

    uname -m

    The result must be greater than or equal to armv71.

  • Basic familiarity with Python 2.7.

Although this tutorial focuses on running AWS Greengrass on a Raspberry Pi or an Amazon EC2 instance, other platforms are supported. For more information, see Supported Platforms and Requirements.

Create an AWS Account

If you don't have an AWS account, follow these steps:

  1. Open the AWS home page, and choose Create an AWS Account.


    If you've signed in to AWS recently, you might see Sign In to the Console instead.

  2. Follow the online instructions. Part of the sign-up procedure involves receiving a phone call and entering a PIN using your phone keypad.


    Ensure that your account has administrative privileges before proceeding.