• The AWS Systems Manager CloudWatch Dashboard will no longer be available after April 30, 2026. Customers can continue to use Amazon CloudWatch console to view, create, and manage their Amazon CloudWatch dashboards, just as they do today. For more information, see [Amazon CloudWatch Dashboard documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Manually installing SSM Agent on Red Hat Enterprise Linux instances
The Amazon Machine Images (AMIs) for Red Hat Enterprise Linux (RHEL) that are provided by AWS do not come with AWS Systems Manager Agent (SSM Agent) preinstalled by default. For a list of AWS managed AMIs on which the agent might be preinstalled, see [Find AMIs with the SSM Agent preinstalled](ami-preinstalled-agent.md).
Use the information in this section to help you manually install or reinstall SSM Agent on a RHEL instance.
**Before you begin**
Before you install SSM Agent on a RHEL instance, note the following:
+ For important information that applies to installation of SSM Agent on all Linux-based operating systems, see [Manually installing and uninstalling SSM Agent on EC2 instances for Linux](manually-install-ssm-agent-linux.md).
+ If you use a `yum` command to update SSM Agent on a managed node after the agent has been installed or updated using the SSM document `AWS-UpdateSSMAgent`, you might see the following message: `"Warning: RPMDB altered outside of yum."` This message is expected and can be safely ignored.
**Topics**
+ [Install SSM Agent on RHEL 8.x, 9.x, and 10.x](agent-install-rhel-8-9.md)
+ [Install SSM Agent on RHEL 7.x](agent-install-rhel-7.md)
# Install SSM Agent on RHEL 8.x, 9.x, and 10.x
The Amazon Machine Images (AMIs) for RHEL 8 and 9 that are provided by AWS do not come with AWS Systems Manager Agent (SSM Agent) preinstalled by default. Use the information on this page to help you install or reinstall the agent on RHEL 8 and 9 instances.
**Before you begin**
Before you install SSM Agent on a RHEL 8, 9, or 10 instance, note the following:
+ Ensure that either Python 2 or Python 3 is installed on your RHEL 8, 9, or 10 instance. This is required in order for SSM Agent to work properly.
**Topics**
+ [Quick installation commands for SSM Agent on RHEL 8, 9, and 10](#quick-install-rhel-8-9)
+ [Create custom agent installation commands for RHEL 8, 9, and 10 in your Region](#custom-url-rhel-8-9)
## Quick installation commands for SSM Agent on RHEL 8, 9, and 10
Use the following steps to manually install SSM Agent on a single instance. This procedure uses globally available installation files.
**To install SSM Agent on RHEL 8.x, 9.x, or 10.x**
1. Connect to your RHEL 8, 9, or 10 instance using your preferred method, such as SSH.
1. Copy the command for your instance’s architecture and run it on the instance.
**Note**
Even though URLs in the following commands include an `ec2-downloads-windows` directory, these are the correct global installation files for RHEL 8, 9, and 10.
x86\$164 instances
```
sudo dnf install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
```
ARM64 instances
```
sudo dnf install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
```
1. (Recommended) Run the following command to verify that the agent is running.
```
sudo systemctl status amazon-ssm-agent
```
In most cases, the command reports that the agent is running, as shown in the following example.
```
● amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/etc/systemd/system/amazon-ssm-agent.service; enabled; vendo>
Active: active (running) since Tue 2025-04-19 16:40:41 UTC; 9s ago
Main PID: 4898 (amazon-ssm-agen)
Tasks: 14 (limit: 4821)
Memory: 34.6M
CGroup: /system.slice/amazon-ssm-agent.service
├─4898 /usr/bin/amazon-ssm-agent
└─4954 /usr/bin/ssm-agent-worker
--truncated--
```
In rare cases, the command reports that the agent is installed but not running, as shown in the following example.
```
● amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/etc/systemd/system/amazon-ssm-agent.service; enabled; vendo>
Active: inactive (dead) since Tue 2025-04-19 16:42:05 UTC; 2s ago
--truncated--
```
To activate the agent in these cases, run the following commands.
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
## Create custom agent installation commands for RHEL 8, 9, and 10 in your Region
When you install SSM Agent on multiple instances using a script or template, we recommend using installation files that are stored in the AWS Region you're working in.
For the following commands, we provide examples that use a publicly accessible S3 bucket in the US East (Ohio) Region (`us-east-2`).
**Tip**
You can also replace a global URL in the procedure [Quick installation commands for SSM Agent on RHEL 8, 9, and 10](#quick-install-rhel-8-9) earlier in this topic with a custom Regional URL you construct.
In the following command, replace *region* with your own information. For a list of supported *region* values, see the **Region** column in [Systems Manager service endpoints](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) in the *Amazon Web Services General Reference*.
**x86\$164**
```
sudo dnf install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm
```
See the following example.
```
sudo dnf install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
```
**ARM64**
```
sudo dnf install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_arm64/amazon-ssm-agent.rpm
```
See the following example.
```
sudo dnf install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm
```
# Install SSM Agent on RHEL 7.x
The Amazon Machine Images (AMIs) for RHEL 7 that are provided by AWS do not come with AWS Systems Manager Agent (SSM Agent) preinstalled by default. Use the information on this page to help you install or reinstall the agent on RHEL 7 instances.
**Topics**
+ [Quick installation commands for SSM Agent on RHEL 7](#quick-install-rhel-7)
+ [Create custom agent installation commands for RHEL 7 in your Region](#custom-url-rhel-7)
## Quick installation commands for SSM Agent on RHEL 7
Use the following steps to manually install SSM Agent on a single instance. This procedure uses globally available installation files.
**To install SSM Agent on RHEL 7.x**
1. Connect to your RHEL 7 instance using your preferred method, such as SSH.
1. Copy the command for your instance’s architecture and run it on the instance.
**Note**
Even though URLs in the following commands include an `ec2-downloads-windows` directory, these are the correct global installation files for RHEL 7.
x86\$164 instances
```
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_amd64/amazon-ssm-agent.rpm
```
ARM64 instances
```
sudo yum install -y https://s3.amazonaws.com/ec2-downloads-windows/SSMAgent/latest/linux_arm64/amazon-ssm-agent.rpm
```
1. (Recommended) Run the following command to verify that the agent is running.
```
sudo systemctl status amazon-ssm-agent
```
In most cases, the command reports that the agent is running, as shown in the following example.
```
● amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/etc/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Tue 2025-04-19 16:47:36 UTC; 22s ago
Main PID: 1342 (amazon-ssm-agen)
CGroup: /system.slice/amazon-ssm-agent.service
├─1342 /usr/bin/amazon-ssm-agent
└─1362 /usr/bin/ssm-agent-worker
--truncated--
```
In rare cases, the command reports that the agent is installed but not running, as shown in the following example.
```
● amazon-ssm-agent.service - amazon-ssm-agent
Loaded: loaded (/etc/systemd/system/amazon-ssm-agent.service; enabled; vendor preset: disabled)
Active: inactive (dead) since Tue 2025-04-19 16:48:56 UTC; 5s ago
Process: 1342 ExecStart=/usr/bin/amazon-ssm-agent (code=exited, status=0/SUCCESS)
Main PID: 1342 (code=exited, status=0/SUCCESS)
--truncated--
```
To activate the agent in these cases, run the following commands.
```
sudo systemctl enable amazon-ssm-agent
```
```
sudo systemctl start amazon-ssm-agent
```
## Create custom agent installation commands for RHEL 7 in your Region
When you install SSM Agent on multiple instances using a script or template, we recommend using installation files that are stored in the AWS Region you're working in.
For the following commands, we provide examples that use a publicly accessible S3 bucket in the US East (Ohio) Region (`us-east-2`).
**Tip**
You can also replace a global URL in the procedure [Quick installation commands for SSM Agent on RHEL 7](#quick-install-rhel-7) earlier in this topic with a custom Regional URL you construct.
In the following command, replace *region* with your own information. For a list of supported *region* values, see the **Region** column in [Systems Manager service endpoints](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) in the *Amazon Web Services General Reference*.
**x86\$164**
```
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_amd64/amazon-ssm-agent.rpm
```
See the following example.
```
sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_amd64/amazon-ssm-agent.rpm
```
**ARM64**
```
sudo yum install -y https://s3.region.amazonaws.com/amazon-ssm-region/latest/linux_arm64/amazon-ssm-agent.rpm
```
See the following example.
```
sudo yum install -y https://s3.us-east-2.amazonaws.com/amazon-ssm-us-east-2/latest/linux_arm64/amazon-ssm-agent.rpm
```