Manually install SSM Agent on EC2 instances for Linux - AWS Systems Manager

Manually install SSM Agent on EC2 instances for Linux

Before you manually install AWS Systems Manager Agent (SSM Agent) on an Amazon Elastic Compute Cloud (Amazon EC2) Linux operating system, review the following information.

  • SSM Agent is installed, by default, on the following EC2 instances and Amazon Machine Images (AMIs):

    • Amazon Linux

    • Amazon Linux 2

    • Amazon Linux 2 ECS-Optimized Base AMIs

    • Ubuntu Server 16.04, 18.04, and 20.04

    Note

    SSM Agent isn't installed on all AMIs based on Amazon Linux or Amazon Linux 2. For example, SSM Agent isn't preinstalled on EKS-Optimized AMIs based on Amazon Linux 2.

  • The manual procedures enable you to install SSM Agent from any AWS Region

  • If you need to install the agent on an on-premises server or a virtual machine (VM) so it can be used with Systems Manager, see Install SSM Agent for a hybrid environment (Linux).

  • An updated version of SSM Agent is released whenever new capabilities are added to Systems Manager or updates are made to existing capabilities. If an older version of the agent is running on an instance, some SSM Agent processes can fail. For that reason, we recommend that you automate the process of keeping SSM Agent up-to-date on your instances. For information, see Automating updates to SSM Agent. Subscribe to the SSM Agent Release Notes page on GitHub to get notifications about SSM Agent updates.

Choose your operating system

Choose a link to view the procedure for manually installing SSM Agent on the specified operating system.

Note

For a list of supported versions of each of the following operating systems, see Supported operating systems.