AWS Greengrass
Developer Guide

Getting Started with AWS Greengrass

This guide is intended to help you start working with AWS Greengrass in as few steps as possible. We will introduce you to the AWS Greengrass programming model and its fundamental concepts, such as AWS Greengrass cores, groups, and subscriptions, and take you through the deployment process to run AWS Lambda functions at the edge. This tutorial is comprised of 6 modules, each designed to help on-board and educate you with AWS Greengrass basics.


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 below.

  • A Raspberry Pi Model 3 with a 8 GB microSD card, or an Amazon EC2 instance. Because AWS Greengrass is intended to be used with physical hardware, we recommend using a Raspberry Pi. However, an Amazon EC2 instance can also be used.

  • Basic familiarity with Python 2.7.

This tutorial focuses on running AWS Greengrass on a Raspberry Pi or an Amazon EC2 instance but 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, it may say 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.