Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Checking the SSM Agent version number
Certain Amazon Systems Manager functionalities have prerequisites that include a minimum Systems Manager
Agent (SSM Agent) version be installed on your managed nodes. You can get the currently
installed SSM Agent version on your managed nodes using the Systems Manager console, or by logging
in to your managed nodes.
The following procedures describe how to get the currently installed SSM Agent version
on your managed nodes.
To check the version number of SSM Agent installed on a managed node
Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/.
In the navigation pane, choose Fleet Manager.
-
In the SSM Agent version column, note the Agent
version number.
To get the currently installed SSM Agent version from within the operating
system
Choose from the following tabs to get the currently installed SSM Agent version
from within an operating system.
- Amazon Linux 1, Amazon Linux 2, and Amazon Linux 2023
-
This command varies depending on the package manager for your
operating system.
-
Log in to your managed node.
-
Run the following command.
yum info amazon-ssm-agent
This command returns output similar to the following.
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name : amazon-ssm-agent
Arch : x86_64
Version : 3.0.655.0
- CentOS
-
-
Log in to your managed node.
-
Run the following command for CentOS 6 and 7.
yum info amazon-ssm-agent
This command returns output similar to the following.
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name : amazon-ssm-agent
Arch : x86_64
Version : 3.0.655.0
- Debian Server
-
-
Log in to your managed node.
-
Run the following command.
apt list amazon-ssm-agent
This command returns output similar to the following.
apt list amazon-ssm-agent
Listing... Done
amazon-ssm-agent/now 3.0.655.0-1 amd64 [installed,local]
3.0.655.0 is the version of SSM agent
- macOS
-
-
Log in to your managed node.
-
Run the following command.
pkgutil --pkg-info com.amazon.aws.ssm
- RHEL
-
-
Log in to your managed node.
-
Run the following command for RHEL 6, 7, 8, and 9.
yum info amazon-ssm-agent
This command returns output similar to the following.
Loaded plugins: extras_suggestions, langpacks, priorities, update-motd
Installed Packages
Name : amazon-ssm-agent
Arch : x86_64
Version : 3.0.655.0
Run the following command for the DNF package utility.
dnf info amazon-ssm-agent
- SLES
-
-
Log in to your managed node.
-
Run the following command for SLES 12 and 15.
zypper info amazon-ssm-agent
This command returns output similar to the following.
Loading repository data...
Reading installed packages...
Information for package amazon-ssm-agent:
-----------------------------------------
Repository : @System
Name : amazon-ssm-agent
Version : 3.0.655.0-1
- Ubuntu Server
-
-
Log in to your managed node.
-
Run the following command for Ubuntu Server 16.04 and 14.04 64-bit
(with deb installer package).
apt list amazon-ssm-agent
This command returns output similar to the following.
apt list amazon-ssm-agent
Listing... Done
amazon-ssm-agent/now 3.0.655.0-1 amd64 [installed,local]
3.0.655.0 is the version of SSM agent
Run the following command for Ubuntu Server 22.04 LTS, 20.10 STR and
20.04, 18.04, and 16.04 LTS 64-bit instances (with Snap
package).
sudo snap list amazon-ssm-agent
This command returns output similar to the following.
snap list amazon-ssm-agent
Name Version Rev Tracking Publisher Notes
amazon-ssm-agent 3.0.529.0 3552 latest/stable/… aws✓ classic-
3.0.529.0 is the version of SSM agent
- Windows
-
-
Log in to your managed node.
-
Run the following PowerShell command.
& "C:\Program Files\Amazon\SSM\amazon-ssm-agent.exe" -version
This command returns output similar to the following.
SSM Agent version: 3.1.804.0
We recommend using the latest version of the SSM Agent so you can benefit from new or
updated capabilities. To ensure your managed instances are always running the most
up-to-date version of the SSM Agent, you can automate the process of updating the
SSM Agent. For more information, see Automating updates to SSM Agent.