how do I uninstall the cloudwatch unified agent from an EC2 instance?


I installed the unified cloudwatch agent on an ec2 instance but now I no longer wish to collect metrics on this particular instance.

How do I uninstall the agent?

I can stop the agent but I would prefer to uninstall it completely (or disable it), because whenever I reboot the instance the agent starts again.

Thank you.

asked 4 years ago6591 views
5 Answers


The procedure varies depending on the host and operating system you are using. The most common are Amazon Linux 2 and Windows.

On Amazon Linux 2 (AL2),

if you installed CloudWatch agent using the yum package manager:

sudo yum -v remove amazon-cloudwatch-agent

if you downloaded and installed CloudWatch agent using rpm package manager:

sudo rpm -v --erase amazon-cloudwatch-agent

On Windows Server, search for Add or Remove Programs, under Apps & Features find Amazon CloudWatch Agent, and click Uninstall.


answered 2 years ago

I have the same problem.

The documentation (link below) states that "You can manually stop the CloudWatch agent using either AWS Systems Manager or the command line. When you stop it manually, you also prevent it from automatically starting at the system reboot."

However, after stopping it manually from the command line, contrary to what's said in the documentation, the CloudWatch agent starts up again after reboot.

So how does one make it stop permanently?

answered 4 years ago

To my knowledge the aws agent is installed as a systemd service on most Linux distros. In order not start it at boot time the service has to be disabled using systemctl. E.g. systemctl disable amazon-ssm-agent.service

answered 4 years ago

Thank you. I think your answer gave me a good hint about why it's not working as per the documentation.

systemctl isn't available on Amazon Linux which we run, however the amazon-cloudwatch-agent-ctl script uses systemctl to do a lot of things, including disabling the service.

answered 4 years ago


Use the following commands to uninstall AWS Systems Manager Agent (SSM Agent) in Ubuntu.

sudo dpkg -r amazon-ssm-agent
sudo snap remove amazon-ssm-agent



answered 2 years ago

You are not logged in. Log in to post an answer.

A good answer clearly answers the question and provides constructive feedback and encourages professional growth in the question asker.

Guidelines for Answering Questions