Version compatibility

Applies to

• Aerospike Developer SDK preview (Java 21+ and Python 3.10+)
• Aerospike Database 6.0 or later unless a section states otherwise

Code examples

Examples assume a connected session from Connect to Aerospike. Each usage guide lists shared imports in a tabbed block near the top of the page; snippet blocks add imports only for types not already shown. The first code block in each section includes dataset setup; later blocks in that section reuse those values. When a page includes a Complete example section, that block is fully self-contained.

This page documents which Developer SDK versions are compatible with which Aerospike Server versions.

Preview

The matrix will expand as preview releases ship. Use Known issues (Preview) for current limitations.

Client ↔ server compatibility

Developer SDK Version	Aerospike Server	Java Version	Python Version
0.9.0-alpha.5 (Python preview)	6.0+	—	3.10–3.14
1.0.x (Java)	6.0+	21+	—

Feature availability by server version

Feature	Min Server Version	Notes
AEL queries	6.0	Requires secondary index
Batch Writes	6.0
Strong Consistency	5.6+	Requires SC namespace
Multi-record transactions (MRT)	8.0+	SC namespace required
GeoJSON bins and GEO2DSPHERE indexes	6.0+
HyperLogLog (HLL) bins	6.0+

Checking your versions

Java

import com.aerospike.client.sdk.Cluster;
import com.aerospike.client.sdk.ClusterDefinition;
import com.aerospike.client.sdk.util.Version;

// Client library version (from the JAR manifest)
ClusterDefinition def = new ClusterDefinition("localhost", 3000);
System.out.println("Developer SDK: " + def.getClientVersion());

// Minimum server version seen across the cluster (after connect)
try (Cluster cluster = def.connect()) {
    Version v = cluster.getVersion();
    System.out.println("Cluster server version (min): " + (v != null ? v : "n/a"));
}

📖 API reference: ClusterDefinition(String,int) | ClusterDefinition.connect() | Cluster.close()

Python

import aerospike_sdk

# Check client version
print(f"Developer SDK: {aerospike_sdk.__version__}")

# Check server version
# version = client.info("version")
# print(f"Server: {version}")

Next steps

• Installation Guide
• Quickstart