Menu
AWS Greengrass
User Guide

Preparing a Raspberry Pi for Greengrass

Follow these steps to prepare your Raspberry Pi for running the AWS Greengrass core software.

To run the AWS Greengrass core software

  1. Use the following commands to add a user named ggc_user and a group named ggc_group:

    Copy
    sudo adduser --system ggc_user sudo addgroup --system ggc_group
  2. Use the following commands to update your Raspberry Pi kernel to 4.9:

    Copy
    sudo apt-get install rpi-update sudo rpi-update
  3. Use the following command to install sqlite3:

    Copy
    sudo apt-get install sqlite3

The AWS Greengrass core software checks if hardlink/softlink protection is activated on the operating system at startup. We recommend that you activate this protection to improve security on your device. Follow these steps.

  1. Set system variables by adding the following two lines to /etc/sysctl.d/98-rpi.conf:

    Copy
    fs.protected_hardlinks = 1 fs.protected_symlinks = 1

    If the file /etc/sysctl.d/98-rpi.conf doesn't exist, follow the instructions in /etc/sysctl.d/README.sysctl.

  2. Reboot the system:

    Copy
    sudo reboot
  3. Validate the change by running:

    Copy
    sudo sysctl -a | grep fs.protected

    If the system variables were set successfully, the following text is displayed:

    Copy
    fs.protected_hardlinks = 1 fs.protected_symlinks = 1