View a markdown version of this page

Install the CodeDeploy agent for macOS - AWS CodeDeploy

Install the CodeDeploy agent for macOS

Sign in to the instance, and run the following commands, one at a time.

Change to your home directory:

cd ~

Download the CodeDeploy agent installer package:

curl -O https://bucket-name.s3.region-identifier.amazonaws.com/latestv2/codedeploy-agent.aarch64.pkg

bucket-name is the name of the Amazon S3 bucket that contains the CodeDeploy Resource Kit files for your region, and region-identifier is the identifier for your region.

For example:

https://aws-codedeploy-us-east-2.s3.us-east-2.amazonaws.com/latestv2/codedeploy-agent.aarch64.pkg

For a list of bucket names and region identifiers, see Resource kit bucket names by Region.

To install the latest version of the CodeDeploy agent:

  • sudo installer -pkg codedeploy-agent.aarch64.pkg -target /

To install a specific version of the CodeDeploy agent:

  • List the available versions in your Region:

    aws s3 ls s3://aws-codedeploy-region-identifier/releases/ --region region-identifier | grep '\.pkg$'
  • Download and install one of the versions:

    aws s3 cp s3://aws-codedeploy-region-identifier/releases/codedeploy-agent-version.aarch64.pkg codedeploy-agent.aarch64.pkg --region region-identifier
    sudo installer -pkg codedeploy-agent.aarch64.pkg -target /

    For the latest released version, see Version history of the CodeDeploy agent.

To check that the service is running, run the following command:

sudo /opt/codedeploy-agent/bin/codedeploy-agent status

If the agent is running, you should see a message like The AWS CodeDeploy agent is running.

If the agent is not running, start the service and check the status:

sudo launchctl kickstart system/com.amazon.aws.codedeploy-agent
sudo /opt/codedeploy-agent/bin/codedeploy-agent status