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.
Topics
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 Managing edge devices with Systems Manager.
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.
Operating system types
Select an OS platform to see the supported major and minor versions.
Linux
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
8.3–8.10 | ✓ | ✓ | |
9.x | ✓ | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
2012.03–2018.03 | ✓ | ✓ |
Note
Beginning with version 2015.03, Amazon Linux 1 was released in x86_64 versions.
Amazon Linux 1 reached the end of its standard support on December 31, 2020, and
reached end of life on December 31, 2023, as announced in Update on Amazon Linux AMI end-of-life
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
2.0 and all later versions | ✓ | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
2023.0.20230315.0 and all later versions |
✓ | ✓ |
Versions | x86_64 | ARM64 |
---|---|---|
1.0.0 and all later versions | ✓ | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
6.x¹ | ✓ | ✓ | |
7.1 and later 7.x versions | ✓ | ✓ | |
8.x | ✓ | ✓ |
¹ 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.
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
8 | ✓ | ✓ | |
9 | ✓ | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
Jessie (8) | ✓ | ||
Stretch (9) | ✓ | ✓ | |
Buster (10) | ✓ | ✓ | |
Bullseye (11) | ✓ | ✓ | |
Bookworm (12) | ✓ | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
7.5–7.8 | ✓ | ||
8.x | ✓ | ||
9.x | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
6.x¹ | ✓ | ✓ | |
7.0–7.5 | ✓ | ||
7.6–8.x | ✓ | ✓ | |
9.x | ✓ | ✓ |
¹ 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.
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
8.x | ✓ | ✓ | |
9.x | ✓ | ✓ |
Versions | x86 | x86_64 | ARM64 |
---|---|---|---|
12 and later 12.x versions | ✓ | ||
15.x | ✓ | ✓ |
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 | ✓ | ✓ | |
23.04, 23.10 | ✓ | ✓ | |
24.04 LTS | ✓ | ✓ | |
24.10 | ✓ | ✓ |
macOS (Amazon EC2 instances only)
Version | x86 | x86_64 | Mac with Apple silicon |
---|---|---|---|
10.14.x (Mojave) | ✓ | ||
10.15.x (Catalina) | ✓ | ||
11.x (Big Sur) | ✓ | ✓ | |
12.x (Monterey) | ✓ | ✓ | |
13.x (Ventura) | ✓ | ✓ | |
14.x (Sonoma) | ✓ | ✓ | |
15.x (Sequoia) | ✓ | ✓ |
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.
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 | ✓ | ||
2025 | ✓ |
¹ Windows Server 2008 and 2008 R2 support: 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.
²
Windows Server 2012 and 2012 R2 support: Windows Server
2012 and 2012 R2 reached end of support on October 10, 2023. To use SSM Agent
with these versions, we recommend using Extended Security Updates (ESUs) from
Microsoft. For more information, see Windows Server 2012 and 2012 R2 reaching end of support
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