Checking the SSM Agent version number - Amazon Systems Manager
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
  1. Open the Amazon Systems Manager console at https://console.amazonaws.cn/systems-manager/.

  2. In the navigation pane, choose Fleet Manager.

  3. 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
Note

This command varies depending on the package manager for your operating system.

  1. Log in to your managed node.

  2. 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
  1. Log in to your managed node.

  2. 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
  1. Log in to your managed node.

  2. 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
  1. Log in to your managed node.

  2. Run the following command.

    pkgutil --pkg-info com.amazon.aws.ssm
RHEL
  1. Log in to your managed node.

  2. 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
  1. Log in to your managed node.

  2. 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
Note

To check if your Ubuntu Server 16.04 instance uses deb or Snap packages, see Manually installing SSM Agent on Ubuntu Server instances.

  1. Log in to your managed node.

  2. 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
  1. Log in to your managed node.

  2. 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.