Menu
AWS CodeDeploy
User Guide (API Version 2014-10-06)

Install or reinstall the AWS CodeDeploy agent for Windows Server

On Windows Server instances, you can use one of these methods to download and install the AWS CodeDeploy agent:

  • Run a series of Windows PowerShell commands

  • Choose a direct download link

  • Run an Amazon S3 copy command

Note

On both new and existing instances, we recommend installing the AWS CodeDeploy agent updater for Windows Server. The updater checks periodically for new versions of the agent and installs it when a new version is available. On new instances, you can install the updater instead of the agent, and the current version of the agent will be installed immediately after the updater. For more information, see Update the AWS CodeDeploy Agent on Windows Server.

Use Windows PowerShell

Sign in to the instance, and run the following commands in Windows PowerShell, one at a time:

Copy
Set-ExecutionPolicy RemoteSigned
Copy
Import-Module AWSPowerShell
Copy
New-Item –Path "c:\temp" –ItemType "directory" -Force
Copy
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
Copy
c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt

bucket-name is the name of the Amazon S3 bucket that contains the AWS CodeDeploy Resource Kit files for your region. For example, for the US East (Ohio) Region, replace bucket-name with aws-codedeploy-us-east-2. For a list of bucket names, see Resource Kit Bucket Names by Region.

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

Copy
powershell.exe -Command Get-Service -Name codedeployagent

If the AWS CodeDeploy agent is installed and running, after the Get-Service command call, you should see output similar to the following:

Copy
Status Name DisplayName ------ ---- ----------- Running codedeployagent CodeDeploy Host Agent Service

If the browser security settings on the Windows Server instance provide the permissions (for example, to http://*.s3.amazonaws.com), you can use a direct link for your region to download the AWS CodeDeploy agent and then run the installer manually.

Use an Amazon S3 Copy Command

If the AWS CLI is installed on the instance, you can use the Amazon S3 cp command to download the AWS CodeDeploy agent and then run the installer manually. For information, see Install the AWS Command Line Interface on Microsoft Windows.

Region name Amazon S3 copy command

US East (Ohio)

Copy
aws s3 cp s3://aws-codedeploy-us-east-2/latest/codedeploy-agent.msi codedeploy-agent.msi

US East (N. Virginia)

Copy
aws s3 cp s3://aws-codedeploy-us-east-1/latest/codedeploy-agent.msi codedeploy-agent.msi

US West (N. California)

Copy
aws s3 cp s3://aws-codedeploy-us-west-1/latest/codedeploy-agent.msi codedeploy-agent.msi

US West (Oregon)

Copy
aws s3 cp s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi codedeploy-agent.msi

Canada (Central)

Copy
aws s3 cp s3://aws-codedeploy-ca-central-1/latest/codedeploy-agent.msi codedeploy-agent.msi

EU (Ireland)

Copy
aws s3 cp s3://aws-codedeploy-eu-west-1/latest/codedeploy-agent.msi codedeploy-agent.msi

EU (London)

Copy
aws s3 cp s3://aws-codedeploy-eu-west-2/latest/codedeploy-agent.msi codedeploy-agent.msi

EU (Frankfurt)

Copy
aws s3 cp s3://aws-codedeploy-eu-central-1/latest/codedeploy-agent.msi codedeploy-agent.msi

Asia Pacific (Tokyo)

Copy
aws s3 cp s3://aws-codedeploy-ap-northeast-1/latest/codedeploy-agent.msi codedeploy-agent.msi

Asia Pacific (Seoul)

Copy
aws s3 cp s3://aws-codedeploy-ap-northeast-2/latest/codedeploy-agent.msi codedeploy-agent.msi

Asia Pacific (Singapore)

Copy
aws s3 cp s3://aws-codedeploy-ap-southeast-1/latest/codedeploy-agent.msi codedeploy-agent.msi

Asia Pacific (Sydney)

Copy
aws s3 cp s3://aws-codedeploy-ap-southeast-2/latest/codedeploy-agent.msi codedeploy-agent.msi

Asia Pacific (Mumbai)

Copy
aws s3 cp s3://aws-codedeploy-ap-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi

South America (São Paulo)

Copy
aws s3 cp s3://aws-codedeploy-sa-east-1/latest/codedeploy-agent.msi codedeploy-agent.msi