Getting Started / Version Requirements / Version Requirements
Version current

Version Requirements

This page documents the version requirements and compatibility policy for Redis OM Spring.

Current Version Requirements

Redis OM Spring has the following version requirements:

Dependency Minimum Version Recommended Version Notes

Spring Boot

4.0.0

4.0.0 or later

Built with Spring Boot 4.0.0

Spring Data Redis

4.0.0

4.0.0 or later

Aligned with Spring Boot version

Spring Framework

7.0.x

Latest 7.x

Transitive via Spring Boot

Jedis

7.0.0

7.0.0 or later

Redis Java client

Java

21

21

Spring Boot 4.x requires Java 21+

Redis Stack

6.2.x

7.2.x or later

For JSON and Search modules

Spring Boot Version Compatibility Policy

Redis OM Spring follows an N-2 support policy for Spring Boot versions:

  • We build with the latest stable Spring Boot version

  • We support the current version and two previous minor versions that are still receiving OSS updates

  • We upgrade Spring Boot with each Redis OM Spring release

Example

As of Redis OM Spring 2.0.0 (November 2025):

  • Built with: Spring Boot 4.0.0

  • Minimum supported: Spring Boot 4.0.0

  • Recommended: Spring Boot 4.0.0 or later

Using older Spring Boot versions may work but is not officially tested or supported. For production use, we recommend staying within the supported version range.

How the Support Policy Works

Release Schedule

Spring Boot releases follow a predictable schedule:

  • New major or minor versions every 6 months (May and November)

  • OSS support for 12 months per minor version

  • Commercial support available for extended periods

Our Approach

  1. On each Redis OM Spring release: We update to the latest stable Spring Boot version

  2. Minimum version: We support versions that are still receiving OSS updates

  3. Testing: We test against all supported Spring Boot versions in our CI pipeline

Determining Supported Versions

To determine which Spring Boot versions Redis OM Spring supports:

  1. Check the springBootVersion in gradle.properties - this is what we build with

  2. Check the Spring Boot support timeline

  3. We support the build version and any previous minor versions still receiving OSS updates

Upgrading Spring Boot

If you need to upgrade your Spring Boot version:

  1. Check the Spring Boot release notes for breaking changes

  2. Update your pom.xml or build.gradle to use the new version

  3. Run your tests to ensure compatibility

  4. Pay special attention to:

    • Spring Data Redis changes

    • Spring Framework changes

    • Java version requirements

Java Version Requirements

Redis OM Spring requires Java 21 or higher because:

  • Spring Boot 4.x requires Java 21 as a minimum

  • We use Java 21 language features in our codebase

  • Java 21 is an LTS (Long Term Support) release

We recommend using Java 21 for production deployments.

Redis Requirements

Redis OM Spring requires Redis Stack or Redis with specific modules:

  • Minimum Redis version: 6.2.x

  • Recommended: Redis Stack 7.2.x or later

  • Required modules:

    • RedisJSON for document storage

    • RediSearch for indexing and querying

You can run Redis Stack using Docker:

docker run -p 6379:6379 redis/redis-stack:latest

Or Redis 8.0+ which includes these capabilities:

docker run -p 6379:6379 redis:8.0.0

Dependency Version Alignment

When using Redis OM Spring, ensure your dependencies are aligned:

<properties>
    <spring-boot.version>4.0.0</spring-boot.version>
    <redis-om-spring.version>2.0.0</redis-om-spring.version>
</properties>

<dependencies>
    <dependency>
        <groupId>com.redis.om</groupId>
        <artifactId>redis-om-spring</artifactId>
        <version>${redis-om-spring.version}</version>
    </dependency>
    <!-- Spring Boot dependencies will be managed by the parent POM -->
</dependencies>

Use Spring Boot’s dependency management to ensure all Spring-related dependencies are aligned with your Spring Boot version.