> For the complete documentation index, see [llms.txt](https://docs.credebl.id/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.credebl.id/docs/references/releases.md).

# Releases

In this section, you will review the release changes.

This section lists every CREDEBL release, newest first, along with the upgrade steps needed when moving between versions.

| Release                                                                  | Released         | Status                                     | Component versions                                                   |
| ------------------------------------------------------------------------ | ---------------- | ------------------------------------------ | -------------------------------------------------------------------- |
| [v2.3.0](https://docs.credebl.id/docs/references/releases/v.2.3.0-rc.md) | 2 November 2026  | **Release candidate** — not for production | Platform `v2.3.0-rc.2`, Agent controller `v2.3.0`                    |
| [v2.2.0](https://docs.credebl.id/docs/references/releases/v.2.2.0.md)    | 13 May 2026      | Latest stable                              | Platform, Studio, Agent controller `v2.2.0`                          |
| [v2.1.3](https://docs.credebl.id/docs/references/releases/v.2.1.3.md)    | 13 November 2025 | Stable                                     | Platform and Agent controller `v2.1.3`, Studio `v2.1.3` (7 May 2026) |
| [v2.1.2](https://docs.credebl.id/docs/references/releases/v.2.1.2.md)    | 23 October 2025  | Stable                                     | Platform, Studio, Agent controller `v2.1.2`                          |
| [v2.1.1](https://docs.credebl.id/docs/references/releases/v.2.1.1.md)    | 15 October 2025  | Stable                                     | Platform, Studio, Agent controller `v2.1.1`                          |
| [v2.1.0](https://docs.credebl.id/docs/references/releases/v.2.1.0.md)    | 9 September 2025 | Stable                                     | Platform, Studio, Agent controller `v2.1.0`                          |

{% hint style="info" %}
Upgrade in order. Each page describes only the changes introduced by that release, so apply every intermediate page when jumping several versions — for example, go from `v2.1.3` through `v2.2.0` before attempting `v2.3.0`.
{% endhint %}

## Choosing a version

* **Production** — use `v2.2.0`, the latest stable release.
* **Evaluation and testing** — use `v2.3.0-rc.2`, which is a release candidate. Expect breaking environment-variable renames and a new database migration.

## Related

* [Platform deployment](https://docs.credebl.id/docs/getting-started/local-deployment/platform.md)
* [Service setup](https://docs.credebl.id/docs/contribute/setup/service-setup.md)
* [Status List Server](https://docs.credebl.id/docs/references/status-list-server.md)
