eks-ami-finder

Helper tool to find Amazon EKS optimized AMI IDs

🔢 Prerequisites

• An IAM Role/User with ec2:DescribeImages permission.

🚀 Quick start

eks-ami-finder help

eks-ami-finder --release-date 202506 # for all AMIs released with specific month (prefix match)

+-----------+-----------------------+-------------------------------------------------------+--------------------------------------------------------------------------------------------+--------------------------+--------------+
| Region    | AMI ID                | Name                                                  | Description                                                                                | DeprecationTime          | Architecture |
+-----------+-----------------------+-------------------------------------------------------+--------------------------------------------------------------------------------------------+--------------------------+--------------+
| us-east-1 | ami-0cf8cd7cb46ff26a0 | amazon-eks-node-al2023-x86_64-standard-1.33-v20250610 | EKS-optimized Kubernetes node based on Amazon Linux 2023, (k8s: 1.33.0, containerd: 1.7.*) | 2027-06-10T07:36:15.000Z | x86_64       |
+-----------+-----------------------+-------------------------------------------------------+--------------------------------------------------------------------------------------------+--------------------------+--------------+

FAQ

Q: How does eks-ami-finder lookup the AMI IDs? what's the magic behind the scene?

A: eks-ami-finder will first find out the Owner IDs of the AMI HERE, then filter out AMI IDs that released by these Owner IDs HERE with patterns, just that simple!

Q: Where can I find he definition for the value of --ami-type flag?

A: See amiType definition here.

👷 Install

For macOS/Linux users (Recommended)

Brand new install

brew tap guessi/tap && brew update && brew install eks-ami-finder

To upgrade version

brew update && brew upgrade eks-ami-finder

Manually setup (Linux, Windows, macOS)

Click to expand!

For Linux users

curl -fsSL https://github.com/guessi/eks-ami-finder/releases/latest/download/eks-ami-finder-Linux-$(uname -m).tar.gz -o - | tar zxvf -
mv -vf ./eks-ami-finder /usr/local/bin/eks-ami-finder

For macOS users

curl -fsSL https://github.com/guessi/eks-ami-finder/releases/latest/download/eks-ami-finder-Darwin-$(uname -m).tar.gz -o - | tar zxvf -
mv -vf ./eks-ami-finder /usr/local/bin/eks-ami-finder

For Windows users

$SRC = 'https://github.com/guessi/eks-ami-finder/releases/latest/download/eks-ami-finder-Windows-x86_64.tar.gz'
$DST = 'C:\Temp\eks-ami-finder-Windows-x86_64.tar.gz'
Invoke-RestMethod -Uri $SRC -OutFile $DST

⚖️ License

Apache-2.0