View a markdown version of this page

Run Amazon IoT Greengrass V2 as a non-root user - Amazon IoT Greengrass
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Run Amazon IoT Greengrass V2 as a non-root user

Typically, the root user installs and runs the Amazon IoT Greengrass Core software on Linux devices. To increase device security, you can set up a non-root user to run the Amazon IoT Greengrass Core software instead. This section provides guidance on setting up non-root configurations.

Choose from the following topics based on your needs:

  • Set up Amazon IoT Greengrass V2 core devices as non-root

    If you are setting up new Amazon IoT Greengrass V2 core devices and want to run them as a non-root user from the start, see Set up Amazon IoT Greengrass V2 core devices as non-root. This guide covers multiple solutions based on your device constraints and security requirements.

  • Migrate Amazon IoT Greengrass V2 core devices to non-root

    If you have existing Amazon IoT Greengrass core devices running as root and want to migrate them to a non-root configuration, see Migrate Amazon IoT Greengrass V2 core devices to non-root.

Note

The non-root configurations in this section apply to Linux devices only. On Windows, Amazon IoT Greengrass must run as a system service.