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 https://s3.region.amazonaws.com/amazon-ssm-region/latest/darwin_amd64/amazon-ssm-agent.pkg

    Here is an example.

    sudo wget https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/darwin_amd64/amazon-ssm-agent.pkg
  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/com.amazon.aws.ssm.plist && sudo launchctl start com.amazon.aws.ssm
Important

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.