AWS Systems Manager
User Guide

Installing and Configuring SSM Agent

AWS Systems Manager Agent (SSM Agent) is Amazon software that runs on your Amazon EC2 instances and your hybrid instances that are configured for Systems Manager (hybrid instances). SSM Agent processes requests from the Systems Manager service in the cloud and configures your machine as specified in the request. SSM Agent sends status and execution information back to the Systems Manager service by using the EC2 Messaging service. If you monitor traffic, you will see your instances communicating with ec2messages.* endpoints. For more information, see Ec2messages and Undocumented API Calls.

SSM Agent is installed, by default, on Amazon EC2 Windows instances and Amazon Linux instances. You must manually install the agent on other versions of Linux and hybrid instances.


The SSM Agent download and installation process for hybrid instances is different than Amazon EC2 instances. For more information, see Install the SSM Agent on Servers and VMs in a Windows Hybrid Environment.

Use the following procedures to install, configure, or uninstall SSM Agent. This section also includes information about configuring SSM Agent to use a proxy. For information about porting SSM Agent logs to Amazon CloudWatch Logs, see Monitoring Instances with AWS Systems Manager.