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

Manually install SSM Agent on EC2 instances for macOS

Connect to your macOS instance and perform the following steps to install AWS Systems Manager Agent (SSM Agent). Perform these steps on each instance that will run commands using Systems Manager.

To install SSM Agent on macOS

  1. Download the agent installer file using the following command.

    sudo wget

    Here is an example.

    sudo wget
  2. Use the following command to run the SSM Agent installer.

    Intel (x86_64) 64-bit instances:

    sudo installer -pkg amazon-ssm-agent.pkg -target /
  3. Check the status of the agent.

    To determine if SSM Agent is running, check the agent log at /var/log/amazon/ssm/amazon-ssm-agent.log .

  4. Run the following command to start the service if the the agent log indicates that "amazon-ssm-agent is stopped."

    sudo launchctl load -w /Library/LaunchDaemons/ && sudo launchctl start

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 a managed node, 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 machines. 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.