# Redis Software release notes 7.22.x ```json metadata { "schema_version": 2, "title": "Redis Software release notes 7.22.x", "description": "Diagnostic logging service. Call home client to send daily usage statistics to Redis. Usage reports in support packages. Revamp database API. Migration status API. Two-dimensional rack awareness. New version for actions API. Additional REST API enhancements.", "categories": ["docs","operate","rs"], "tableOfContents": {"sections":[{"id":"highlights","title":"Highlights"},{"id":"detailed-release-notes","title":"Detailed release notes"},{"children":[{"id":"breaking-changes","title":"Breaking changes"},{"id":"reserved-ports","title":"Reserved ports"},{"id":"deprecations","title":"Deprecations"},{"id":"supported-platforms","title":"Supported platforms"}],"id":"version-changes","title":"Version changes"},{"id":"known-issues","title":"Known issues"},{"id":"known-limitations","title":"Known limitations"}]} , "codeExamples": [] } ``` ​​Redis Software version 7.22 is now available! ## Highlights This version offers: - Performance improvements - Diagnostic logging service - Call home client to send daily usage statistics to Redis - Usage reports in support packages - Revamp database API - Migration status API - Two-dimensional rack awareness - New version for actions API - Additional REST API enhancements ## Detailed release notes For more detailed release notes, select a build version from the following table: | Version (Release date) | Major changes | Redis Open Source compatibility | | --- | --- | --- | | [7.22.2-204 (October 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-204/) | Bug fixes for DMC proxy stability. Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-189 (September 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-189/) | Added scoping for shards and database endpoints. Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-179 (August 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-179/) | Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-170 (July 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-170/) | Improved proxy efficiency. Bug fix for a node join failures due to misidentified IPv6 addresses. Bug fix for -MOVED response metrics visibility. Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-133 (May 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-133/) | Bug fix for an issue where the Sentinel service could become unresponsive while processing certain commands due to a timing issue. Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-116 (April 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-116/) | Bug fixes for node manager crashes after cluster upgrades and the creation of circular symlinks during cluster upgrades. Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-93 (March 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-93/) | Bug fix for flash database percent capacity displayed in the Cluster Manager UI. Internal fixes and improvements. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-79 (February 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-79/) | Bug fixes for configuration updates on promoted shards after failover, database recovery, certificate validation, and database availability API responses. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-55 (January 2026)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-55/) | Bug fixes for configuring backups and memory limits in the Cluster Manager UI, and database metrics collection. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-41 (November 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-41/) | Bug fixes for `cluster_wd` configuration after restarts and internode encryption certificate storage and retrieval. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-20 (October 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-20/) | Cluster Manager UI bug fixes for issues with S3 periodic backups configuration and connection issues. API bug fixes for omitted default values in responses and Active-Active database creation failures. | Redis 7.4.3, 7.2.7, 6.2.13 | | [7.22.2-14 (September 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-2-14/) | Customer-managed certificates for internode encryption. Cluster Manager UI bug fixes for viewing shard memory usage metrics and editing Active-Active databases that have participating clusters with empty ports. | Redis 7.4.2, 7.2.7, 6.2.13 | | [7.22.0-250 (August 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-0-250/) | Bug fix for LDAPS port configuration in the Cluster Manager UI. Internal fixes and improvements. | Redis 7.4.2, 7.2.7, 6.2.13 | | [7.22.0-241 (July 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-0-241/) | Bug fixes for LDAP authentication, Active-Active databases, database recovery, support package generation, memory leaks, and the Cluster Manager UI. | Redis 7.4.2, 7.2.7, 6.2.13 | | [7.22.0-216 (June 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-0-216/) | license_expiration_days metric for monitoring. Bug fixes for user password management REST API requests, cluster setup in the Cluster Manager UI, cluster upgrades, maintenance mode snapshot cleanup, database availability API performance, Active-Active syncing, and more. | Redis 7.4.2, 7.2.7, 6.2.13 | | [7.22.0-95 (May 2025)](https://redis.io/docs/latest/operate/rs/release-notes/rs-7-22-releases/rs-7-22-0-95/) | Diagnostic logging service. Call home client to send daily usage statistics to Redis. Usage reports in support packages. Revamp database API. Migration status API. Two-dimensional rack awareness. New version for actions API. Additional REST API enhancements. | Redis 7.4.2, 7.2.7, 6.2.13 | ## Version changes - The fully qualified domain name is now validated using the FQDN library instead of a regex during cluster creation. ### Breaking changes - Redis Software installation script changes: - Added `--skip-updating-env-path` option to [`install.sh`](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/install-script). - Added `skip_updating_env_path` parameter to the [installation answers file](https://redis.io/docs/latest/operate/rs/installing-upgrading/install/manage-installation-questions#configure-file-to-answer). ### Reserved ports Make sure the following ports are open before upgrading Redis Software. Ports reserved as of Redis Software version 7.22.0: | Port | Process name | Usage | |------|--------------|-------| | 3346 | cluster_api_internal | Cluster API internal port | | 3351 | cluster_watchdog_grpc_api | Cluster watchdog now supports gRPC | | 3352 | grpc_service_mesh | gRPC communication between nodes | | 3353 | local_grpc_service_mesh | Local gRPC services | | 3354 | grpc_gossip_envoy | gRPC gossip protocol communication between nodes | | 3355 | authentication_service | Authentication service internal port | Ports reserved as of Redis Software version 7.8.2: | Port | Process name | Usage | |------|--------------|-------| | 3347 | cert_exporter | Reports cluster certificate metrics | | 3348 | process_exporter | Reports process metrics for DMC and Redis processes | | 3349 | cluster_wd_exporter | Reports cluster watchdog metrics | | 3350 | db_controller | Internode communication | | 9091 | node_exporter | Reports host node metrics related to CPU, memory, disk, and more | | 9125 | statsd_exporter | Reports push metrics related to the DMC and syncer, and some cluster and node metrics | See [Ports and port ranges used by Redis Software](https://redis.io/docs/latest/operate/rs/networking/port-configurations#ports-and-port-ranges-used-by-redis-enterprise-software) for a complete list. ### Deprecations #### API deprecations - Deprecated [`GET /v1/bdbs//actions/optimize_shards_placement`](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/bdbs/actions/optimize_shards_placement#get-bdbs-actions-optimize-shards-placement) REST API request. Use [`PUT /v1/bdbs//actions/revamp?dry_run=true`](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/bdbs/actions/revamp#put-bdbs-actions-revamp) to get an optimized shard placement blueprint for a database instead. - Deprecated the `data_files` option for the `recovery_plan` specified in [`POST /v2/bdbs`](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/bdbs#post-bdbs-v2) requests. Use the new `original_bdb_shards` option to recover a database from the provided list of shards instead. - Deprecated [`PUT /v1/cluster/update_cert`](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/cluster/certificates#put-cluster-update_cert) REST API requests as of Redis Software version 7.22.2. Use [`PUT /v1/cluster/certificates`](https://redis.io/docs/latest/operate/rs/references/rest-api/requests/cluster/certificates#put-cluster-certificates) to update cluster certificates instead. #### Internal monitoring and v1 Prometheus metrics deprecation The existing [internal monitoring engine](https://redis.io/docs/latest/operate/rs/monitoring/v1_monitoring) is deprecated. We recommend transitioning to the new [metrics stream engine](https://redis.io/docs/latest/operate/rs/monitoring/metrics_stream_engine) for improved performance, enhanced integration capabilities, and modernized metrics streaming. V1 Prometheus metrics are deprecated but still available. To transition to the new metrics stream engine, either migrate your existing dashboards using [this guide](https://redis.io/docs/latest/operate/rs/references/metrics/prometheus-metrics-v1-to-v2) now, or wait to use new preconfigured dashboards when they become available in a future release. ### Supported platforms The following table provides a snapshot of supported platforms as of this Redis Software release. See the [supported platforms reference](https://redis.io/docs/latest/operate/rs/references/supported-platforms) for more details about operating system compatibility. ✅ Supported – The platform is supported for this version of Redis Software and Redis Stack modules. :warning: Deprecation warning – The platform is still supported for this version of Redis Software, but support will be removed in a future release. | Redis Software
major versions | 8.0 | 7.22 | 7.8 | 7.4 | 7.2 | 6.4 | 6.2 | |---------------------------------|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:|:-----:| | **Release date** | Oct 2025 | May 2025 | Nov 2024 | Feb 2024 | Aug 2023 | Feb 2023 | Aug 2021 | | [**End-of-life date**](https://redis.io/docs/latest/operate/rs/installing-upgrading/product-lifecycle#endoflife-schedule) | Determined after
next major release | Oct 2027 | May 2027 | Nov 2026 | Feb 2026 | Aug 2025 | Feb 2025 | | **Platforms** | | | | | | | | | RHEL 9 &
compatible distros[1](#table-note-1) | ✅ | ✅ | ✅ | ✅ | – | – | – | | RHEL 9
FIPS mode[5](#table-note-5) | ✅ | ✅ | ✅ | – | – | – | – | | RHEL 8 &
compatible distros[1](#table-note-1) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | RHEL 7 &
compatible distros[1](#table-note-1) | – | – | – | – | :warning: | :warning: | :warning: | | Ubuntu 22.04[2](#table-note-2) | ✅ | ✅ | ✅ | – | – | – | – | | Ubuntu 20.04[2](#table-note-2) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | | Ubuntu 18.04[2](#table-note-2) | – | – | – | :warning: | :warning: | :warning: | :warning: | | Ubuntu 16.04[2](#table-note-2) | – | – | – | – | :warning: | :warning: | :warning: | | Amazon Linux 2 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | – | | Amazon Linux 1 | – | – | – | – | :warning: | :warning: | :warning: | | Kubernetes[3](#table-note-3) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | Docker[4](#table-note-4) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 1. The RHEL-compatible distributions CentOS, CentOS Stream, Alma, and Rocky are supported if they have full RHEL compatibility. Oracle Linux running the Red Hat Compatible Kernel (RHCK) is supported, but the Unbreakable Enterprise Kernel (UEK) is not supported. 2. The server version of Ubuntu is recommended for production installations. The desktop version is only recommended for development deployments. 3. See the [Redis Enterprise for Kubernetes documentation](https://redis.io/docs/latest/operate/kubernetes/reference/supported_k8s_distributions) for details about support per version and Kubernetes distribution. 4. [Docker images](https://redis.io/docs/latest/operate/rs/installing-upgrading/quickstarts/docker-quickstart) of Redis Software are certified for development and testing only. 5. Supported only if [FIPS was enabled during RHEL installation](https://docs.redhat.com/en/documentation/red_hat_enterprise_linux/9/html/security_hardening/switching-rhel-to-fips-mode_security-hardening#proc_installing-the-system-with-fips-mode-enabled_switching-rhel-to-fips-mode) to ensure FIPS compliance. ## Known issues - RS131972: Creating an ACL that contains a line break in the Cluster Manager UI can cause shard migration to fail due to ACL errors. - RS155734: Endpoint availability metrics do not work as expected due to a calculation error. - RS156391: The `job_scheduler`'s memory usage can increase significantly when the diagnostic logging service is enabled. ## Known limitations #### Upload modules before OS upgrade If the cluster contains any databases that use modules, you must upload module packages for the target OS version to a node in the existing cluster before you upgrade the cluster's operating system. See [Upgrade a cluster's operating system](https://redis.io/docs/latest/operate/rs/installing-upgrading/upgrading/upgrade-os) for detailed upgrade instructions. #### New Cluster Manager UI limitations The following legacy UI features are not yet available in the new Cluster Manager UI: - Purge an Active-Active instance. Use [`crdb-cli crdb purge-instance`](https://redis.io/docs/latest/operate/rs/references/cli-utilities/crdb-cli/crdb/purge-instance) instead. - Search and export the log. #### RedisGraph prevents upgrade to RHEL 9 You cannot upgrade from a prior RHEL version to RHEL 9 if the Redis Software cluster contains a RedisGraph module, even if unused by any database. The [RedisGraph module has reached end-of-life](https://redis.com/blog/redisgraph-eol/) and is completely unavailable in RHEL 9. #### Query results might include hash keys with lazily expired fields If one or more fields of a hash key expire after an `FT.SEARCH` or `FT.AGGREGATE` query begins, Redis does not account for these lazily expired fields. As a result, keys with expired fields might still be included in the query results, leading to potentially incorrect or inconsistent results. #### Active defragmentation does not stop mid-key for JSON Active defragmentation does not stop mid-key for JSON data. Large keys are defragmented in full, which might cause latency spikes.