Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Docker for AWS Greengrass

Development, testing, simulations are all good reasons towant to run AWS Greengrass Core in a docker container. This repo provides a simple Ubuntu-based Greengrass Core Docker image.

The trick to running it in Docker is to use devicemapper storage driver instead of default overlay2 (thanks AWS support for digging it out).

CAUTION: when you change the Docker storage driver, you won't see the images and containers created with the old storage driver, until you change it back. Details here

Build the AWS Greengras image

docker build -t aws-greengrass .

Run the AWS Greengrass container

  1. Place your Greengrass Core certificates and keys under certs/

  2. Adjust config.json under config/ to point to the certificates and emails

    When you create a Greengrass Core in AWS console, and Download and store your Core's security resources, the download contains the certificates and core configuration. Just copy them over here to certs/ and config/.

  3. Run the container:

    docker run --rm -it \
    -v "$PWD/certs":/greengrass/certs \
    -v $PWD/config:/greengrass/config \
    --privileged \

    Or use docker-compose:

    docker-compose up

For MacOS and Windows users

You can build the image on MacOS and Windows, but can not run it.

The devicemapper trick doesn't work for MacOS or Windows, as Docker doesn't support the devicemapper storage driver there. Instead, use the Vagrant Ubuntu VM: docker is installed and configured to use devicemapper.

Create the VM with vagrant up, log inside with vagrant ssh, and proceed with the steps before. Either pull the image from Docker Hub, or just rebuild it inside Vagrant VM.


Docker image for AWS Greengrass






No releases published


No packages published