Supported operating systems and machine types - AWS Systems Manager

Supported operating systems and machine types

Before working with Systems Manager, verify that your operating system (OS), OS version, and machine type are supported as managed nodes.

Supported operating systems for Systems Manager

The following sections list the OSs and OS versions supported by Systems Manager.

Note

If you plan to manage and configure AWS IoT Greengrass core devices by using Systems Manager, those devices must meet the requirements for AWS IoT Greengrass. For more information, see Setting up AWS IoT Greengrass core devices in the AWS IoT Greengrass Version 2 Developer Guide.

If you plan to manage and configure AWS IoT and non-AWS edge devices, those devices must meet the requirements listed here and be configured as on-premises managed nodes for Systems Manager. For more information, see Setting up AWS Systems Manager for edge devices.

Important

Patch Manager, a capability of Systems Manager, might not support all the OS versions listed in this topic. For a list of OS versions supported by Patch Manager, see Patch Manager prerequisites.

Linux

AlmaLinux
Versions x86 x86_64 ARM64
8.3–8.7; 9.0–9.2
Amazon Linux
Versions x86 x86_64 ARM64
2012.03–2018.03
Note

Beginning with version 2015.03, Amazon Linux is released in x86_64 versions.

Amazon Linux 2
Versions x86 x86_64 ARM64
2.0 and all later versions
Amazon Linux 2023
Versions x86 x86_64 ARM64

2023.0.20230315.0 and all later versions

Bottlerocket
Versions x86_64 ARM64
1.0.0 and all later versions
CentOS
Versions x86 x86_64 ARM64
6.x¹
7.1 and later 7.x versions
8.0–8.5

¹ To use these versions, you must use a 3.0.x version of the SSM Agent. We recommend using the latest available 3.0.x version of the SSM Agent. Later SSM Agent versions (3.1 or later) are not supported.

CentOS Stream
Versions x86 x86_64 ARM64
8
Debian Server
Versions x86 x86_64 ARM64
Jessie (8)
Stretch (9)
Buster (10)
Bullseye (11)
Oracle Linux
Versions x86 x86_64 ARM64
7.5–7.8
8.1–8.7
9.0–9.2
Red Hat Enterprise Linux (RHEL)
Versions x86 x86_64 ARM64
6.x¹
7.0–7.5
7.6–8.8
9.0–9.2

¹ To use these versions, you must use a 3.0.x version of the SSM Agent. We recommend using the latest available 3.0.x version of the SSM Agent. Later SSM Agent versions (3.1 or later) are not supported.

Rocky Linux
Versions x86 x86_64 ARM64
8.4–8.7
9.0–9.2
SUSE Linux Enterprise Server (SLES)
Versions x86 x86_64 ARM64
12 and later 12.x versions
15 and later 15.x versions
Ubuntu Server
Versions x86 x86_64 ARM64
12.04 LTS and 14.04 LTS
16.04 LTS and 18.04 LTS
20.04 LTS and 20.10 STR
22.04 LTS

macOS (Amazon EC2 instances only)

Version x86 x86_64 ARM64
10.14.x (Mojave)
10.15.x (Catalina)
11.x (BigSur)
12.x (Monterey)
13.x (Ventura)
Note

macOS is not supported in all AWS Regions. For more information about Amazon EC2 support for macOS, see Amazon EC2 Mac instances in the Amazon EC2 User Guide for Linux Instances.

Raspberry Pi OS (formerly Raspbian)

Version ARM32
8 (Jessie)
9 (Stretch)

Windows Server

SSM Agent requires Windows PowerShell 3.0 or later to run certain AWS Systems Manager documents (SSM documents) on Windows Server instances (for example, the legacy AWS-ApplyPatchBaseline document). Verify that your Windows Server instances are running Windows Management Framework 3.0 or later. This framework includes Windows PowerShell. For more information, see Windows Management Framework 3.0.

Version x86 x86_64 ARM64
2008¹
2008 R2¹
2012 and 2012 R2
2016
2019
2022

¹ As of January 14, 2020, Windows Server 2008 is no longer supported for feature or security updates from Microsoft. Legacy Amazon Machine Images (AMIs) for Windows Server 2008 and 2008 R2 still include version 2 of SSM Agent preinstalled, but Systems Manager no longer officially supports 2008 versions and no longer updates the agent for these versions of Windows Server. In addition, SSM Agent version 3 might not be compatible with all operations on Windows Server 2008 and 2008 R2. The final officially supported version of SSM Agent for Windows Server 2008 versions is 2.3.1644.0.

Supported machine types in hybrid and multicloud environments

Systems Manager supports a number of machine types as managed nodes. A managed node is any machine configured to work with Systems Manager.

This user guide uses the term hybrid and multicloud to refer to an environment that contains any combination of the following machine types:

  • Amazon Elastic Compute Cloud (Amazon EC2) instances

  • Servers on your own premises (on-premises servers)

  • AWS IoT Greengrass core devices

  • AWS IoT and non-AWS edge devices

  • Virtual machines (VMs), including VMs in other cloud environments

For information about AWS support for hybrid and multicloud environments, see AWS Solutions for Hybrid and Multicloud.