Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Verify the CodeDeploy agent is running

Focus mode
Verify the CodeDeploy agent is running - AWS CodeDeploy

This section describes commands to run if you suspect the CodeDeploy agent has stopped running on an instance.

Verify the CodeDeploy agent for Amazon Linux or RHEL is running

To see if the CodeDeploy agent is installed and running, sign in to the instance, and run the following command:

systemctl status codedeploy-agent

If the command returns an error, the CodeDeploy agent is not installed. Install it as described in Install the CodeDeploy agent for Amazon Linux or RHEL.

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

If you see a message like error: No AWS CodeDeploy agent running, start the service and run the following two commands, one at a time:

systemctl start codedeploy-agent
systemctl status codedeploy-agent

Verify the CodeDeploy agent for Ubuntu Server is running

To see if the CodeDeploy agent is installed and running, sign in to the instance, and run the following command:

systemctl status codedeploy-agent

If the command returns an error, the CodeDeploy agent is not installed. Install it as described in Install the CodeDeploy agent for Ubuntu Server.

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

If you see a message like error: No AWS CodeDeploy agent running, start the service and run the following two commands, one at a time:

systemctl start codedeploy-agent
systemctl status codedeploy-agent

Verify the CodeDeploy agent for Windows Server is running

To see if the CodeDeploy agent is installed and running, sign in to the instance, and run the following command:

powershell.exe -Command Get-Service -Name codedeployagent

You should see output similar to the following:

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

If the command returns an error, the CodeDeploy agent is not installed. Install it as described in Install the CodeDeploy agent for Windows Server.

If Status shows anything other than Running, start the service with the following command:

powershell.exe -Command Start-Service -Name codedeployagent

You can restart the service with the following command:

powershell.exe -Command Restart-Service -Name codedeployagent

You can stop the service with the following command:

powershell.exe -Command Stop-Service -Name codedeployagent
PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.