NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Go modules
Go modules, #1098 by repository stars
Latest stable
v1.25.6
Last release 1 months ago
20 Oct 2026
Ships fairly regularly
a new release about every 2 months
Nearly every release is documented
notes for 55 of 56 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
133 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Upgrade toolchain to go1.25.8 by @tiationg-kho in https://github.com/aws/aws-node-termination-handler/pull/1259
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.25.5...v1.25.6
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Upgrade vulnerable depdendencies by @Lu-David in https://github.com/aws/aws-node-termination-handler/pull/1252
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.25.4...v1.25.5
e04dab6
This commit was created on GitHub.com and signed with GitHub’s verified signature .
GPG key ID: B5690EEEBB952194
Verified Learn about vigilant mode .
Full Changelog : v1.25.4...v1.25.5
Lu-David
Fix node tainting when using UseProviderId with SQS monitors by @Sithembiso-Mashinini in https://github.com/aws/aws-node-termination-handler/pull/1203
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.25.3...v1.25.4
Update readme to add windows 2019 deprecation notice by @tanmaysankhe in https://github.com/aws/aws-node-termination-handler/pull/1193
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.25.2...v1.25.3
Removing support for windows 2019 as the windows 2019 is deprecated
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.25.1...v1.25.2
Nothing published for this version
Modified cache and ubuntu versions to resolve the build failures by @LikithaVemulapalli in https://github.com/aws/aws-node-termination-handler/pull/11
Draining the node message by @der-eismann in https://github.com/aws/aws-node-termination-handler/pull/1149Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.25.0...v1.25.1
Prometheus add nodes gauge for SQS mode by @phuhung273 in https://github.com/aws/aws-node-termination-handler/pull/1083
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.24.0...v1.25.0
Nothing published for this version
Add filtering before DeleteOrEvictPods by @tiationg-kho in https://github.com/aws/aws-node-termination-handler/pull/1106
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.23.1...v1.24.0
Deprecate old k8s version by @tiationg-kho in https://github.com/aws/aws-node-termination-handler/pull/1107
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.23.0...v1.23.1
synchronize the linux and windows release process to avoid overwriting the manifest by @bwagner5 in https://github.com/aws/aws-node-termination-handle
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.22.1...v1.23.0
Bump github.com/aws/aws-sdk-go from 1.53.0 to 1.53.5 by @dependabot in https://github.com/aws/aws-node-termination-handler/pull/1009
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.22.0...v1.22.1
Nothing published for this version
add k8s 1.29 to test versions by @cjerad in https://github.com/aws/aws-node-termination-handler/pull/986
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.21.0...v1.22.0
Nothing published for this version
Nothing published for this version
The actions_node metric is deprecated due to the potential for high cardinality causing an issue for downstream consumers. A new metric actions has be…
actions_node metric is deprecated due to the potential for high cardinality causing an issue for downstream consumers. A new metric actions has been added to take the place of actions_node without the potential for high cardinality. This release publishes both metrics but actions_node will be removed in a future release.Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.20.0...v1.21.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
optionally delete sqs message when node not found by @cjerad in https://github.com/aws/aws-node-termination-handler/pull/801
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.19.0...v1.20.0
Nothing published for this version
Nothing published for this version
Error log fix by @LikithaVemulapalli in https://github.com/aws/aws-node-termination-handler/pull/756
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.18.3...v1.19.0
Replaced deprecated config checkASGTagBeforeDraining in end-to-end tests by @snay2 in https://github.com/aws/aws-node-termination-handler/pull/753
checkASGTagBeforeDraining in end-to-end tests by @snay2 in https://github.com/aws/aws-node-termination-handler/pull/753Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.18.2...v1.18.3
Nothing published for this version
Modified ScheduledChangeRule in cfn-template by @LikithaVemulapalli in https://github.com/aws/aws-node-termination-handler/pull/737
T.Setenv to set env vars in tests by @Juneezee in https://github.com/aws/aws-node-termination-handler/pull/739Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.18.1...v1.18.2
Upgrade some dependencies by @snay2 in https://github.com/aws/aws-node-termination-handler/pull/731
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.18.0...v1.18.1
v1.18.0 introduces the logFormatVersion Helm chart option, to allow you to opt-in to more detailed logs.
v1.18.0 introduces the logFormatVersion Helm chart option, to allow you to opt-in to more detailed logs.
The default value is 1, which keeps logging the same way it did in prior releases (<= v1.17.3).
Setting the value to 2 will give you more detail about which AWS event triggered the cordon/drain. Previously, all these events were bucketed under SQS_TERMINATE and it was difficult to tell what was happening.
This option is also available as a command line flag, --log-format-version
logFormatVersion=2 modifies several Debug, Info, and Warn logs, as well as Kubernetes events emitted by NTH. These changes improve your observability about what NTH is doing when responding to events via SQS. If your monitoring system is configured to look for any of the specific strings in the tables below, you may need to modify your configuration to use the updated strings if you use the new log format version.
event_type field from the Info log when starting a monitor; replace with monitor_type field, with new values. See Table 1.event_type field from the Warn log when a monitor fails to start; replace with monitor_type field, with new values. See Table 1.monitor field in the Info log. See Table 1.kind field in the Info log, if running Queue Processor mode. See Table 2.SQS_TERMINATE in the Debug log if running Queue Processor mode. See Table 2.| Previous | New |
|---|---|
REBALANCE_RECOMMENDATION |
REBALANCE_RECOMMENDATION_MONITOR |
SCHEDULED_EVENT |
SCHEDULED_EVENT_MONITOR |
SPOT_ITN |
SPOT_ITN_MONITOR |
SQS_TERMINATE |
SQS_MONITOR |
| Previous | New |
|---|---|
REBALANCE_RECOMMENDATION |
REBALANCE_RECOMMENDATION |
SCHEDULED_EVENT |
SCHEDULED_EVENT |
SPOT_ITN |
SPOT_ITN |
SQS_TERMINATE |
REBALANCE_RECOMMENDATION SCHEDULED_EVENT SPOT_ITN STATE_CHANGE ASG_LIFECYCLE |
| Previous reason | New reason |
|---|---|
RebalanceRecommendation |
RebalanceRecommendation |
ScheduledEvent |
ScheduledEvent |
SpotInterruption |
SpotInterruption |
SQSTermination |
RebalanceRecommendation ScheduledEvent SpotInterruption StateChange ASGLifecycle |
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.17.3...v1.18.0
Add back deprecated flags for checking whether an instance is managed by NTH by @snay2 in https://github.com/aws/aws-node-termination-handler/pull/686
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.17.2...v1.17.3
Add optional pause prior to completing lifecycle action by @cjerad in https://github.com/aws/aws-node-termination-handler/pull/680
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.17.1...v1.17.2
divide log output between stdout and stderr by @cjerad in https://github.com/aws/aws-node-termination-handler/pull/676
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.17.0...v1.17.1
These may be breaking changes, depending on your setup:
These may be breaking changes, depending on your setup:
v1.17.0 supports both configs, but you'll see a warning if you use the deprecated name. We may remove the deprecated configs altogether in a future release.
CheckASGTagBeforeDraining and replace it with CheckTagBeforeDrainingManagedAsgTag replace it with ManagedTagFull Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.16.5...v1.17.0
Nothing published for this version
delete test notification by @cjerad in https://github.com/aws/aws-node-termination-handler/pull/644
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.16.4...v1.16.5
Ignore test notification Event by @cjerad in https://github.com/aws/aws-node-termination-handler/pull/640
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.16.3...v1.16.4
Nothing published for this version
Remove AssumeAsgTagPropagation by @brycahta in https://github.com/aws/aws-node-termination-handler/pull/632
AssumeAsgTagPropagation by @brycahta in https://github.com/aws/aws-node-termination-handler/pull/632Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.16.2...v1.16.3
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix Helm chart service labels by @stevehipwell in https://github.com/aws/aws-node-termination-handler/pull/615
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.16.1...1.16.2
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Add IsManaged nodeinfo field to scheduled events by @boffbowsh in https://github.com/aws/aws-node-termination-handler/pull/601
Full Changelog: https://github.com/aws/aws-node-termination-handler/compare/v1.16.0...v1.16.1
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.