# Upgrade guide

This guide helps you upgrade between versions of the Developer SDK.

::: coming soon
This page is under development. Content will include:

-   Version-by-version upgrade instructions
-   Breaking changes and migration steps
-   Deprecation notices
:::

## Upgrading from classic client

If you’re migrating from the classic Aerospike client, see the [Migration Guide](https://aerospike.com/docs/develop/client/sdk/concepts/migration).

## Version upgrade paths

### 0.9.x → 1.0.x (preview → GA)

**Breaking Changes**: None expected.

**New Features**:

-   Expanded DSL operators
-   Improved batch performance

**Migration Steps**:

-   [Java](#tab-panel-3074)
-   [Python](#tab-panel-3075)

```xml
<!-- Update your pom.xml -->

<dependency>

    <groupId>com.aerospike</groupId>

    <artifactId>aerospike-client-sdk</artifactId>

    <version>1.0.0</version>  <!-- was 0.9.0 -->

</dependency>
```

Terminal window

```bash
# Upgrade via pip

pip install --upgrade aerospike-sdk
```

---

## Deprecation policy

-   Deprecated APIs are marked with `@Deprecated` (Java) or deprecation warnings (Python)
-   Deprecated APIs remain functional for at least 2 minor versions
-   Migration guidance is provided in release notes

## Compatibility considerations

Before upgrading, verify:

1.  Your Aerospike Server version is compatible ([Version Compatibility](https://aerospike.com/docs/develop/client/sdk/reference/compatibility))
2.  Your Java/Python runtime meets minimum requirements

## Next steps

-   [Version Compatibility](https://aerospike.com/docs/develop/client/sdk/reference/compatibility)
-   [Migration from Classic Client](https://aerospike.com/docs/develop/client/sdk/concepts/migration)