v2.11.12

nats-io/nats-serverv2.11.12Jan 27, 2026by github-actions[bot]

AI Summary

Patch release for NATS server v2.11.x with extensive bug fixes across JetStream, MQTT, and general components. Includes new WebSocket configuration and monitoring enhancements.

Key Highlights

  • Go version updated to 1.25.6
  • Added WebSocket-specific ping interval configuration with `ping_internal`
  • Added `tls_cert_not_after` to varz monitoring endpoint
  • Extensive MQTT fixes including retained messages, QoS handling, and account mapping
  • Multiple JetStream performance and reliability improvements

New Features

  • WebSocket ping interval configuration via `ping_internal` in websocket block
  • TLS certificate expiration monitoring via `tls_cert_not_after` in varz endpoint

Full Release Notes

## Changelog

Refer to the [2.11 Upgrade Guide](https://docs.nats.io/release-notes/whats_new/whats_new_211) for backwards compatibility notes with 2.10.x.

### Go Version

- 1.25.6 (#7736)

### Dependencies

- github.com/nats-io/nkeys v0.4.12 (#7578)
- github.com/antithesishq/antithesis-sdk-go v0.5.0-default-no-op (#7604)
- github.com/klauspost/compress v1.18.3 (#7736)
- golang.org/x/crypto v0.47.0 (#7736)
- golang.org/x/sys v0.40.0 (#7736)
- github.com/google/go-tpm v0.9.8 (#7696)
- github.com/nats-io/nats.go v1.48.0 (#7696)

### Added

General

- Added WebSocket-specific ping interval configuration with `ping_internal` in the `websocket` block (#7614)

Monitoring

- Added `tls_cert_not_after` to the `varz` monitoring endpoint for showing when TLS certificates are due to expire (#7709)

### Improved

JetStream

- The scan for the last sourced message sequence when setting up a subject-filtered source is now considerably faster (#7553)
- Consumer interest checks on interest-based streams are now significantly faster when there are large gaps in interest (#7656)
- Creating consumer file stores no longer contends on the stream lock, improving consumer create performance on heavily loaded streams (#7700)
- Recalculating num pending with updated filter subjects no longer gathers and sorts the subject filter list twice (#7772)
- Switching to interest-based retention will now remove no-interest messages from the head of the stream (#7766)

MQTT

- Retained messages will now work correctly even when sourced from a different account and has a subject transform (#7636)

### Fixed

General

- WebSocket connections will now correctly limit the buffer size during decompression (#7625, thanks to Pavel Kokout at Aisle Research)
- The config parser now correctly detects and errors on self-referencing environment variables (#7737)
- Internal functions for handling headers should no longer corrupt message bodies if appended (#7752)

JetStream

- A protocol error caused by an invalid transform of acknowledgement reply subjects when originating from a gateway connection has been fixed (#7579)
- The meta layer will now only respond to peer remove requests after quorum has been reached (#7581)
- Invalid subject filters containing non-terminating full wildcard no longer produce unexpected matches (#7585)
- A data race when creating a stream in clustered mode has been fixed (#7586)
- A panic when processing snapshots with missing nodes or assignments has been fixed (#7588)
- When purging whole message blocks, the subject tracking and scheduled messages are now updated correctly (#7593)
- The filestore will no longer unexpectedly lose writes when `AsyncFlush` is enabled after a process pause (#7594)
- The filestore now will process message removal on disk before updating accounting, which improves error handling (#7595, #7601)
- Raft will no longer allow peer-removing the one remaining peer (#7610)
- A data race has been fixed in the stream health check (#7619)
- Tombstones are now correctly written for recovering the sequences after compacting or purging an almost-empty stream to seq 2 (#7627)
- Combining skip sequences and compactions will no longer overwrite the block at the wrong offset, correcting a `corrupt record state` error (#7627)
- Compactions that reclaim over half of the available space now use an atomic write to avoid losing messages if killed (#7627)
- Filestore compaction should no longer result in `no idx present` cache errors (#7634)
- Filestore compaction now correctly adjusts the high and low sequences for a message block, as well as cleaning up the deletion map accordingly (#7634)
- Potential stream desyncs that could happen during stream snapshotting have been fixed (#7655)
- Raft will no longer allow multiple membership changes to take place concurrently (#7565, #7609)
- Raft will no longer count responses from peer-removed nodes towards quorum (#7589)
- Raft quorum counting has been refactored so the implicit leader ack is now only counted if still a part of the membership (#7600)
- Raft now writes the peer state immediately when handling a peer-remove to ensure the removed peers cannot unexpectedly reappear after a restart (#7602)
- Raft will no longer allow peer-removing the one remaining peer (#7610)
- Add peer operations to Raft can no longer result in disjoint majorities (#7632)
- Raft groups should no longer readmit a previously removed peer if a heartbeat occurs between the peer removal and the leadership transfer (#7649)
- Raft single node elections now transition into leader state correctly (#7642)
- R1 streams will no longer incorrectly drift last sequence when exceeding limits (#7658)
- Deleted streams are no longer wrongfully revived if stalled on an upper-layer catchup (#7668)
- A panic that could happen when receiving a shutdown signal while JetStream is still starting up has been fixed (#7683)
- JetStream usage stats now correctly reflect purged whole blocks when optimising large purges (#7685)
- Recovering JetStream encryption keys now happens independently of the stream index recovery, fixing some cases where the key could be reset unexpectedly if the index is rebuilt (#7678)
- Non-replicated file-based consumers now detect corrupted state on disk and are deleted automatically (#7691)
- Raft no longer allows a repeat vote for the same term after a stepdown or leadership transfer (#7698)
- Replicated consumers are no longer incorrectly deleted if they become leader just as JetStream is about to shut down (#7699)
- Fixed an issue where a single truncated block could prevent storing new messages in the filestore (#7704)
- Fixed a concurrent map iteration/write panic that could occur on WorkQueue streams during partitioning (#7708)
- Fixed a deadlock that could occur on shutdown when adding streams (#7710)
- A data race on mirror consumers has been fixed (#7716)
- JetStream no longer leaks subscriptions in a cluster when a stream import/export is set up that overlaps the `$JS.>` namespace (#7720)
- The filestore will no longer waste CPU time rebuilding subject state for WALs (#7721)
- Configuring `cluster_traffic` in config mode has been fixed (#7723)
- Subject intersection no longer misses certain subjects with specific patterns of overlapping filters, which could affect consumers, num pending calculations etc (#7728, #7741, #7744, #7745)
- Multi-filtered next message lookups in the filestore can now skip blocks when faster to do so (#7750)
- The binary search for start times now handles deleted messages correctly (#7751)
- Consumer updates will now only recalculate num pending when the filter subjects are changed (#7753)
- Consumers on replicated interest or workqueue streams should no longer lose interest or cause desyncs after having their filter subjects updated (#7773)
- Interest-based streams will no longer start more check interest state goroutines when there are existing running ones (#7769)

MQTT

- The maximum payload size is now correctly enforced for MQTT clients (#7555, thanks to @yixianOu)
- Fixed a panic that could occur when reloading config if the user did not have permission to access retained messages (#7596)
- Fixed account mapping for JetStream API requests when traversing non-JetStream-enabled servers (#7598)
- QoS0 messages are now mapped correctly across account imports/exports with subject mappings (#7605)
- Loading retained messages no longer fails after restarting due to last sequence checks (#7616)
- A bug which could corrupt retained messages in clustered deployments has been fixed (#7622)
- Permissions to `$MQTT.` subscriptions are now handled implicitly, with the exception of `deny` ACLs which still permit restriction (#7637)
- A bug where QoS2 messages could not be retrieved after a server restart has been fixed (#7643)

### Complete Changes
 
https://github.com/nats-io/nats-server/compare/v2.11.11...v2.11.12