# etcd v3.5.26

2025-12-17 · [Original release notes](https://github.com/etcd-io/etcd/releases/tag/v3.5.26) · [Full summary](https://ratatosk.io/en/releases/etcd/v3.5.26)

Security 2 · Important fixes 1 · Dependency updates 1 · Other changes 4

## Check before upgrading

### Upgrade guide

- **Upgrade guidance for possible breaking changes**
  > Please check out [CHANGELOG](https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md) for a full list of changes. And make sure to read [upgrade guide](https://etcd.io/docs/v3.5/upgrades/upgrade_3_5/) before upgrading etcd (there may be breaking changes).

## Security (2)

### Raw tokens removed from etcd authentication logs

- Affects: etcd authentication logs for JWT and simple-token flows (Inferred)

Previously, these messages logged the original token; they now log its first 12 hexadecimal SHA-256 hash characters as `token-fingerprint`.

> - [Print token fingerprint instead of the original tokens in log messages](https://github.com/etcd-io/etcd/pull/20942)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

### SSH Agent and GSSAPI request handling flaws fixed

- Affects: setups using `golang.org/x/crypto/ssh/agent` for new identity requests or `golang.org/x/crypto/ssh` for GSSAPI authentication requests
- [CVE-2025-47914](https://www.cve.org/CVERecord?id=CVE-2025-47914), [CVE-2025-58181](https://www.cve.org/CVERecord?id=CVE-2025-58181)

Malformed new-identity requests could panic SSH Agent servers, while GSSAPI authentication requests could cause SSH servers to consume unbounded memory. `golang.org/x/crypto` is upgraded to the patched version, 0.45.0.

> - Bump [golang.org/x/crypto to 0.45.0 to address CVE-2025-47914, and CVE-2025-58181](https://github.com/etcd-io/etcd/pull/21023).

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

## Important fixes (1)

### Stale `v3store` member entries cleaned up

- Affects: etcd cluster membership in `v3store`

Stale entries could remain after snapshot restores using `etcdctl snapshot restore` versions <= v3.4.39, or after a `ForceNewCluster` restart on versions < v3.5.22 in the described crash scenario. They are deleted when etcd updates local member attributes, applies a snapshot, or applies a ConfChange with `shouldApplyV3` true.

> - Fix [zombie members in v3store](https://github.com/etcd-io/etcd/pull/20995)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

## Dependency updates (1)

1 more, none mentioning security

- `- Compile binaries using [go 1.24.11](https://github.com/etcd-io/etcd/pull/20999).`

## Other changes (4)

- Updated macOS installation example for v3.5.26
- Docker installation docs identify primary and secondary registries
- Docker example updated to run etcd v3.5.26
- Snapshot command help text corrected to name `etcdutl`

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
