Use Systems Manager Use Windows PowerShell Use a direct link Use an Amazon S3 copy command

Install the CodeDeploy agent for Windows Server

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

Use AWS Systems Manager (recommended)
Run a series of Windows PowerShell commands.
Choose a direct download link.
Run an Amazon S3 copy command.

Note

The folder that the CodeDeploy agent is installed to is C:\Program Data\Amazon\CodeDeploy. Make sure there are no directory junctions or symlinks on this path.

Use Systems Manager

Follow the instructions in Install the CodeDeploy agent using AWS Systems Manager to install the CodeDeploy agent.

Use Windows PowerShell

Require that all scripts and configuration files downloaded from the Internet be signed by a trusted publisher. If you are prompted to change the execution policy, type "Y."
```
 Set-ExecutionPolicy RemoteSigned
```
Load the AWS Tools for Windows PowerShell.
```
Import-Module AWSPowerShell
```
Create a directory into where the CodeDeploy agent installation file is downloaded.
```
New-Item -Path "c:\temp" -ItemType "directory" -Force
```
Configure AWS credentials using the Set-AWSCredential and Initialize-AWSDefaultConfiguration commands. For more information, see Using AWS credentials in the AWS tools for PowerShell User Guide.
Download the CodeDeploy agent installation file.

Note
The minimum supported version of the CodeDeploy agent is 1.5.0. CodeDeploy agent 1.5.0 is not supported on Windows Server 2022.

To install the latest version of the CodeDeploy agent:
- ```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key latest/codedeploy-agent.msi -File c:\temp\codedeploy-agent.msi
```
To install a specific version of the CodeDeploy agent:
- ```
powershell.exe -Command Read-S3Object -BucketName bucket-name -Key releases/codedeploy-agent-###.msi -File c:\temp\codedeploy-agent.msi
```
bucket-name is the name of the Amazon S3 bucket that contains the 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.

Run the CodeDeploy agent installation file.


c:\temp\codedeploy-agent.msi /quiet /l c:\temp\host-agent-install-log.txt

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


powershell.exe -Command Get-Service -Name codedeployagent

If the CodeDeploy agent was just installed and has not been started, then after running the Get-Service command, under Status, you should see Start...:



Status     Name                DisplayName
------     ----                -----------
Start...   codedeployagent    CodeDeploy Host Agent Service

If the CodeDeploy agent is already running, after running the Get-Service command, under Status, you should see Running:



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

Use a direct link

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 CodeDeploy agent and then run the installer manually.

Important

Choose the .msi file that is in the same Region as your CodeDeploy application. Choosing a different Region may cause inconsistent region failures in the codedeploy-agent-log file when you run the .msi file.

Region name	Download link
US East (Ohio)	`https://aws-codedeploy-us-east-2.s3.amazonaws.com/latest/codedeploy-agent.msi`
US East (N. Virginia)	`https://aws-codedeploy-us-east-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
US West (N. California)	`https://aws-codedeploy-us-west-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
US West (Oregon)	`https://aws-codedeploy-us-west-2.s3.amazonaws.com/latest/codedeploy-agent.msi`
Canada (Central)	`https://aws-codedeploy-ca-central-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
Europe (Ireland)	`https://aws-codedeploy-eu-west-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
Europe (London)	`https://aws-codedeploy-eu-west-2.s3.amazonaws.com/latest/codedeploy-agent.msi`
Europe (Paris)	`https://aws-codedeploy-eu-west-3.s3.amazonaws.com/latest/codedeploy-agent.msi`
Europe (Frankfurt)	`https://aws-codedeploy-eu-central-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Hong Kong)	`https://aws-codedeploy-ap-east-1.s3.ap-east-1.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Tokyo)	`https://aws-codedeploy-ap-northeast-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Seoul)	`https://aws-codedeploy-ap-northeast-2.s3.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Singapore)	`https://aws-codedeploy-ap-southeast-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Sydney)	`https://aws-codedeploy-ap-southeast-2.s3.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Melbourne)	`https://aws-codedeploy-ap-southeast-4.s3.ap-southeast-4.amazonaws.com/latest/codedeploy-agent.msi`
Asia Pacific (Mumbai)	`https://aws-codedeploy-ap-south-1.s3.amazonaws.com/latest/codedeploy-agent.msi`
South America (São Paulo)	`https://aws-codedeploy-sa-east-1.s3.amazonaws.com/latest/codedeploy-agent.msi`

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 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)	`aws s3 cp s3://aws-codedeploy-us-east-2/latest/codedeploy-agent.msi codedeploy-agent.msi`
US East (N. Virginia)	`aws s3 cp s3://aws-codedeploy-us-east-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
US West (N. California)	`aws s3 cp s3://aws-codedeploy-us-west-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
US West (Oregon)	`aws s3 cp s3://aws-codedeploy-us-west-2/latest/codedeploy-agent.msi codedeploy-agent.msi`
Canada (Central)	`aws s3 cp s3://aws-codedeploy-ca-central-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
Europe (Ireland)	`aws s3 cp s3://aws-codedeploy-eu-west-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
Europe (London)	`aws s3 cp s3://aws-codedeploy-eu-west-2/latest/codedeploy-agent.msi codedeploy-agent.msi`
Europe (Paris)	`aws s3 cp s3://aws-codedeploy-eu-west-3/latest/codedeploy-agent.msi codedeploy-agent.msi`
Europe (Frankfurt)	`aws s3 cp s3://aws-codedeploy-eu-central-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Hong Kong)	`aws s3 cp s3://aws-codedeploy-ap-east-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Tokyo)	`aws s3 cp s3://aws-codedeploy-ap-northeast-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Seoul)	`aws s3 cp s3://aws-codedeploy-ap-northeast-2/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Singapore)	`aws s3 cp s3://aws-codedeploy-ap-southeast-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Sydney)	`aws s3 cp s3://aws-codedeploy-ap-southeast-2/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Melbourne)	`aws s3 cp s3://aws-codedeploy-ap-southeast-4/latest/codedeploy-agent.msi codedeploy-agent.msi`
Asia Pacific (Mumbai)	`aws s3 cp s3://aws-codedeploy-ap-south-1/latest/codedeploy-agent.msi codedeploy-agent.msi`
South America (São Paulo)	`aws s3 cp s3://aws-codedeploy-sa-east-1/latest/codedeploy-agent.msi codedeploy-agent.msi`

Warning Javascript is disabled or is unavailable in your browser.

To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions.

Document Conventions

Install the CodeDeploy agent for Ubuntu Server

Update the CodeDeploy agent