# AWS Session Manager Plugin

AWS CLI plugin for authorized shell, SSH transport, and port-forwarding sessions to Systems Manager managed nodes, without a separate desktop application.

> This is the Markdown version of the AWS Session Manager Plugin page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/session-manager-plugin>

- **Latest version**: `1.2.896.0`
- **Developer**: Amazon Web Services
- **Homepage**: <https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask session-manager-plugin`
- **30-day installs**: 14,585
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
- **SHA-256**: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`
- **Commands**: session-manager-plugin
- **Installer packages**: session-manager-plugin.pkg

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "pkgutil": "session-manager-plugin"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "session-manager-plugin.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "session-manager-plugin.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "binary": [
        "/usr/local/sessionmanagerplugin/bin/session-manager-plugin"
      ],
      "target": "$HOMEBREW_PREFIX/bin/session-manager-plugin"
    },
    "phase": "install",
    "sources": [
      "/usr/local/sessionmanagerplugin/bin/session-manager-plugin"
    ],
    "target": "$HOMEBREW_PREFIX/bin/session-manager-plugin",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "/Library/LaunchDaemons/SessionManagerPlugin.plist"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

The Session Manager plugin lets the AWS CLI start interactive shell, SSH transport, and port-forwarding sessions to AWS Systems Manager managed nodes. It is a local command-line component for cloud administrators, developers, and operations teams, not the SSM Agent installed on remote nodes or a standalone desktop app.

### Features
- Start and end sessions through AWS CLI commands and IAM authorization.
- Access managed nodes without opening inbound SSH ports for ordinary Session Manager shell sessions.
- Forward ports to managed nodes or reachable remote hosts using supported session documents.
- Use configured session shell profiles and AWS logging options where the session type supports them.
- Use SSH-style shell escape sequences in version 1.2.835.0, including ~. to terminate and ~? for help.

### macOS installation and first use
Install `brew install --cask session-manager-plugin`. The cask installs the official architecture-specific signed PKG under /usr/local/sessionmanagerplugin and links its executable into the Homebrew bin directory. Administrative approval can be required. Check `session-manager-plugin --version` and your AWS CLI configuration, then start an authorized session with `aws ssm start-session --target i-EXAMPLE`. Replace the example with a real managed-node ID and choose the correct region/profile. These are instructions, not claims that a session has been tested on your account.

### Dependencies and remote prerequisites
AWS documents AWS CLI 1.16.12 or later as the local minimum; use a currently supported CLI release. You need AWS credentials with appropriate IAM permissions. Remote nodes need SSM Agent, an appropriate instance role or hybrid activation configuration, and outbound connectivity to the required Systems Manager endpoints. The base session prerequisite is SSM Agent 2.3.68.0 or later; port forwarding and other features can require newer agent versions. A local plugin does not turn an unmanaged machine into a managed node. SSH-over-Session-Manager additionally requires the usual SSH client/server and authentication setup.

The signed PKG used by Homebrew differs from AWS's alternative ZIP bundle. AWS documents Python 3.10 or later for the ZIP installer script; do not treat that script requirement as an extra Homebrew runtime dependency. Go and build tools in the source README are for building from source. Homebrew declares no extra formula dependency, explicit macOS minimum, or package conflict. Existing manual installations or PATH links can collide with the cask's executable location; check the selected binary before reinstalling.

### Platform support
AWS provides native packages for macOS Intel and Apple Silicon and separate Windows and Linux installers. This Homebrew cask installs only the Mac package. AWS's referenced installation guide does not specify a universal numeric minimum macOS version, so no unsupported minimum is asserted here. Managed-node operating-system support is a separate Systems Manager requirement and is not the same as the plugin's local host support. This is not an iOS or Android application. AWS currently requires plugin 1.2.764.0 or later for supported operations; the listed 1.2.835.0 exceeds that minimum.

### Accounts, costs, and license
The plugin is open source under Apache License 2.0 and has no separate plugin subscription. Operational use requires an AWS account or authorized access to one. EC2 resources, hybrid/advanced management, logging, storage, network services, and other optional AWS capabilities can incur charges; installing a free plugin does not make the surrounding cloud resources free. Consult AWS's current pricing for the intended configuration. Ordinary shell session logging can be configured, but SSH and port-forwarded content have different logging limitations.

### Official references
- [Plugin repository and Apache license](https://github.com/aws/session-manager-plugin)
- [Plugin installation](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
- [macOS installers](https://docs.aws.amazon.com/systems-manager/latest/userguide/install-plugin-macos-overview.html)
- [Session prerequisites](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-prerequisites.html)
- [Release history](https://docs.aws.amazon.com/systems-manager/latest/userguide/plugin-version-history.html)
- [Systems Manager pricing](https://aws.amazon.com/systems-manager/pricing/)

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 1.2.896.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Checked 2026-11-22
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac/session-manager-plugin.pkg>
  - SHA-256: `d9d960f04acb5ba419e0a12f769f9af4f3263e098b9b63e2de659189c138341a`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 1.2.896.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Checked 2026-11-22
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
  - SHA-256: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`

## AWS Session Manager Plugin security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/aws/session-manager-plugin> · Open source: Yes — <https://github.com/aws/session-manager-plugin> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask session-manager-plugin`

A regular uninstall removes the app and keeps its settings and caches.

### Uninstalling also removes

- Installer receipts (pkgutil): `session-manager-plugin` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

### Deep clean (optional)

- `brew uninstall --zap --cask session-manager-plugin`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `/Library/LaunchDaemons/SessionManagerPlugin.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.2.896.0 (2026-10-21)

Reverts the change titled “Session failure reason check and avoid hanging session.”

Reverts the change titled “Session failure reason check and avoid hanging session.”

Source: https://github.com/aws/session-manager-plugin/releases/tag/1.2.896.0

## Facts and sources

- <https://opennavo.com/apps/session-manager-plugin>
- <https://opennavo.com/apps/session-manager-plugin/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/session-manager-plugin>
- <https://github.com/aws/session-manager-plugin> · Checked 2026-11-13
