# Getting Started

* For new installations, see our [Installation Guide](/docs/archive/ces-25.03/install.md)
* For upgrading existing Ceph clusters, refer to our [Migration Guide](/docs/archive/ces-25.03/category/migrate.md)
* For version-specific features and fixes, check the [Release Notes](/docs/archive/ces-25.03/release-notes.md)

These CES images are based on upstream Ceph releases with some additional patches and bug fixes. Clyso strives to keep these images compatible with upstream, meaning there will always be a path to upgrade out of CES releases to upstream Ceph releases.

### Current Release[​](#current-release "Direct link to Current Release")

| CES Version | Based on Ceph Version | Image                                                       | Release Notes                                             |
| ----------- | --------------------- | ----------------------------------------------------------- | --------------------------------------------------------- |
| 25.03.2     | v18.2.7 (Reef)        | harbor.clyso.com/ces/ceph/ceph<!-- -->:ces-v25<!-- -->.03.2 | [Release Notes](/docs/archive/ces-25.03/release-notes.md) |
| 25.03.1     | v18.2.4 (Reef)        | harbor.clyso.com/ces/ceph/ceph<!-- -->:ces-v25<!-- -->.03.1 | [Release Notes](/docs/archive/ces-25.03/release-notes.md) |

### Upgrade Compatibility Matrix[​](#upgrade-compatibility-matrix "Direct link to Upgrade Compatibility Matrix")

| From Version | To Version  | Compatibility   | Notes                                                                         |
| ------------ | ----------- | --------------- | ----------------------------------------------------------------------------- |
| Ceph 18.2.4  | CES 25.03.1 | Supported       | Safe upgrade path                                                             |
| CES 25.03.1  | Ceph 18.2.4 | ⚠️ Known Issues | Will encounter upgrade bug ([tracker](https://tracker.ceph.com/issues/67660)) |
| Ceph 18.2.7  | CES 25.03.2 | Supported       | Bidirectional compatibility                                                   |
| CES 25.03.2  | Ceph 18.2.7 | Supported       | Bidirectional compatibility                                                   |

**Recommended Migration Paths:**

* **From CES 25.03.1**: Migrate to Ceph 18.2.7 or CES 25.03.2
* **From CES 25.03.2**: Compatible with Ceph 18.2.7+
* **To CES**: Any upstream Ceph version can migrate to corresponding or newer CES version

### Upgrading[​](#upgrading "Direct link to Upgrading")

To upgrade out of CES to Ceph upstream version or vice versa, visit the [Cephadm-based migration](/docs/archive/ces-25.03/migrate/Cephadm-based-migration.md) guide.

### Key Features by Version[​](#key-features-by-version "Direct link to Key Features by Version")

#### 25.03.2 (Current)[​](#25032-current "Direct link to 25.03.2 (Current)")

* Based on Ceph Reef (v18.2.7)
* Enhanced RGW lifecycle management and object lock support
* Improved BlueStore and kernel device handling
* Advanced S3 API compatibility improvements
* Performance optimizations for object storage workloads

#### 25.03.1[​](#25031 "Direct link to 25.03.1")

* Based on Ceph Reef (v18.2.4)
* Intermediate stability release with targeted fixes
* Compatible with upstream 18.2.4+

To get started with CES, cephadm is the preferred utility to manage a ceph cluster. Please contact Clyso Support for RPM packages.

## Versioning and Release Information[​](#versioning-and-release-information "Direct link to Versioning and Release Information")

### Overview[​](#overview "Direct link to Overview")

Clyso Enterprise Storage (CES) is built on Ceph technology and follows a structured versioning system to ensure stability and compatibility. Each CES version is carefully tested and optimized with specific Ceph releases to provide enterprise-grade reliability.

### Version Numbering[​](#version-numbering "Direct link to Version Numbering")

CES follows a `YY.MM.X` versioning scheme:

* `YY`: Release year (e.g., 24 for 2024)
* `MM`: Release month (e.g., 11 for November)
* `X`: Patch version number (starting at 0)

### Additional Resources[​](#additional-resources "Direct link to Additional Resources")

* [Ceph Copilot Documentation](/docs/archive/ces-25.03/ceph-copilot.md)
* [Knowledge Base Articles](/docs/kb.md)