Skip to main content

Versioning and upgrades

Upgrades​

Running security-critical open source technology in a self-service format requires vigilance. We make your life easier by announcing important software updates via the Ory Security Newsletter. Never miss an update and sign up now to important release updates!

Good software improves over time. If it wouldn't, you shouldn't use it. Unfortunately, some of these improvements have breaking changes. We know that breaking changes are annoying so we want to make upgrading as painless as possible.

We document changelogs and upgrade guides for Ory services:

Before upgrading to a newer version, please make sure to check with these documents first.

Versioning​

Ory uses a calendar-based versioning system, where the version format is YY.Q.N, representing the year, quarter, and release number within that quarter. For example, version 25.2.0 indicates a release in the second quarter of 2025, with 0 being the first release in that quarter. The release number increases with each subsequent release during the quarter. This system helps users understand when a version was released and how recent it is. Starting from October 2025, all Ory components use a common version number, meaning releases are synchronized across all components such as Kratos, Hydra, Oathkeeper, and Keto. This unified versioning simplifies upgrades and ensures compatibility across the entire Ory ecosystem.