Koha Versioning

Koha has gone through a number of different versioning schemes over its 20+ year existence. For recent discussions see:
* Next proposals discussion
* LTS workflow proposal
== Current Release Model (2016-) ==
=== Version Numbering ===
During the development cycle of Koha 3.24 the community decided to switch from a feature based version numbering scheme to a time-based one, with the first release following this scheme being 16.05.
XX.YY.ZZ.AAA
* XX - The release year.
* YY - The release month. (05 for May, 11 for November)
* ZZ - The maintenance increment. Denotes a 'bugfix' release. The introduction of patches to fix bugs in existing features only, no enhancements and no new features.
* AAA - The database increment. This increment is used to track the database schema.
==== 16.05 → Present ====
* Pro: You will know easily how old the version you are using is.
* Con: There isn't an obvious change in the version number to denote big feature changes.
=== Development & Maintenance ===
A feature stable release is made once every six months, during May (XX.05) and November (XX.11), and a new release team is elected for the next six-month cycle at this time.
The normal feature stable release is then maintained for an average of 18 months (dependent upon volunteers for the maintainer role) and a new bugfix release, which includes many fixes for bugs backported from the upstream development version, is made each month during this period.
The development version of Koha should not be run in production and can be clearly distinguished by it's version number which will either be XX.06 or XX.12.
=== LTS Releases (2022-) ===
22.11 will be the first official Long Term Support Release. (Decision: Development IRC meeting 3 August 2022)
* LTS releases will be maintained for 3.5 years
* Normal releases will be maintained for 18 months.
* LTS releases will overlap for 1.5 years.    
Released in	New release 	Older maintained versions	Older maintained versions	Older maintained versions	Older maintained versions	Older maintained versions	Older maintained versions
suite 	stable 	oldstable 	oldoldstable 	oldoldoldstable 	oldoldoldstable 	oldoldoldstable 	oldoldoldstable
 	(1-6 months)	(7-12 months) 	(13-18 months) 	(19-24 months) 	(25-30 months) 	(31-36 months) 	(37-42 months)
Nov 2022 	22.11 LTS 	22.05 	21.11 	21.05 	 	 	
May 2023 	23.05 	22.11 LTS 	22.05 	21.11 	 	 	
Nov 2023 	23.11 	23.05 	22.11 LTS 	22.05 	 	 	
May 2024 	24.05 	23.11 	23.05 	22.11 LTS 	 	 	
Nov 2024 	24.11 LTS 	24.05 	23.11 	 	22.11 LTS 	 	
May 2025 	25.05 	24.11 LTS 	24.05 	 	 	22.11 LTS 	
Nov 2025 	25.11 	25.05 	24.11 LTS 	 	 	 	22.11 LTS
May 2026 	26.05 	25.11 	25.05 	24.11 LTS 	 	 	EOL 22.11
Nov 2026 	26.11 LTS 	26.05 	25.11 	 	24.11 LTS 	 	
May 2027 	27.11 	26.11 LTS 	26.05 	 	 	24.11 LTS 	
 	11/19	05/20	11/20	05/21	11/21	05/22	11/22	05/23	11/23	05/24	11/24	05/25	11/25	05/26	11/26	05/27	11/27	05/28	11/28
19.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
20.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
20.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
21.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
21.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
22.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
22.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
23.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
23.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
24.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
24.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
25.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
25.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
26.05	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
26.11	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	 	
=== Codenames ===
With the above 18 month maintenance period, it results in usually supporting 4 feature stable releases concurrently and these follow the standard Debian repository naming scheme of stable, oldstable and oldoldstable.
As an example, in January 2025 the most current feature stable version of Koha will be 24.11 and the community will be maintaining:
* Koha 24.11 LTS (stable)
* Koha 24.05 (oldstable)
* Koha 23.11 (oldoldstable)
* Koha 22.11 LTS (oldoldoldstable) 
=== Recommendations ===
For production environments, the recommended method of installation is to use the Debian packages, paying close attention to the follow a suite section.
* If you want to want to run the most bug-free release of Koha at any given time you should track the oldoldstable branch.
* If you want the most feature rich version of Koha and don't mind dealing with a few bugs every few months then the stable branch is for you.
* The happy middle ground of oldstable will get new features 6 months later than stable, but should be considerably more tried and tested and as such more bug free.
* If you prefer to run a version for a longer time with less major updates, the LTS version might be your choice.
== Prior Release Models ==
=== Version Numbering ===
Koha's original version number scheme was based solely on features.
X.YY.ZZ.AAA
* X - The major increment. This was meant to denote a large change in Koha: The introduction of zebra for bibliographic indexing for example.
* YY - The minor increment. This was meant to denote a new feature bundle release: The introduction of new feature and enhancements to existing features that didn't warrant a major increment change.
* ZZ - The maintenance increment. This was meant to denote new bugfix releases: The introduction of patches to fix bugs in existing features only, no enhancements and not new features.
* AAA - The database increment. This increment is used to track the database schema.
==== 1.0 → 3.2 (2000-2010) ====
Koha's original releases were based upon 'targeted features'. The community would set out what they aimed to achieve at the beginning of a cycle and the release would only become official once all those features were implemented.
* Pro: You know what you will have
* Con: Delayed releases (more than 1 year for 3.2)
==== 3.2 → 3.22 (2010-2016) ====
After the unusually long wait for the 3.2 release of Koha, the community decided to adopt a time-based approach to releases. A minor release of Koha would be done every 6 months, independently from what new features it may contain.
* Pro: Predictable release dates
* Con: If a feature you were expecting hadn't made the cut by a certain deadline, you would have to wait a further 6 months for it to be included in an official release.
Category:About_Koha
Category:Release Management