23 Sep 2021
Koha is the first free and open source software library automation package (ILS). Development is sponsored by libraries of varying types and sizes, volunteers, and support companies from around the world. The website for the Koha project is:
Koha 21.05.04 can be downloaded from:
Installation instructions can be found at:
Koha 21.05.04 is a bugfix/maintenance release with security fixes.
It includes 6 security fixes, 1 enhancements, 20 bugfixes.
You can learn about the system components (like OS and database) needed for running Koha here: https://wiki.koha-community.org/wiki/System_requirements_and_recommendations
[26195] Add a way to specify authorised values should be expanded [OAI]
This enhancement adds a new option to the OAI configuration file, to tell it to expand authorised values.
[28373] Items fields not used in default XSLT
When processing records for display we loop through each field in the record and translate authorized values into descriptions. Item fields in the record contain many authorised values, and the lookups can cause a delay in displaying the record. If using the default XSLT these fields are not displayed as they exist in the record, so parsing them is not necessary and can save time. This bug adds a system preference that disables sending these fields for processing and thus saving time. Enabling the system preference will allow users to pass the items to custom style sheets if needed.
[28774] Warnings from GetIssuingCharge when rental discount is not set
This fixes the cause of warning messages in the log files when the rental discount in the circulation rules has a blank value.
Before this fix, multiple warning messages "[2021/07/28 12:11:25] [WARN] Argument "" isn't numeric in subtraction (-) at /kohadevbox/koha/C4/Circulation.pm line 3385." appeared in the log files. These warnings occurred for items checked out where they had rental charges and the rental discount value in the circulation rules was blank.
[28554] In itemsearch sort filters by description
For item search in the staff interface the shelving location and item type values are now sorted by the description, rather than the authorized value code.
The Koha manual is maintained in Sphinx. The home page for Koha documentation is
As of the date of these release notes, the Koha manual is available in the following languages:
The Git repository for the Koha manual can be found at
Complete or near-complete translations of the OPAC and staff interface are available in this release for the following languages:
Partial translations are available for various other languages.
The Koha team welcomes additional translations; please see
For information about translating Koha, and join the koha-translate list to volunteer:
The most up-to-date translations can be found at:
The release team for Koha 21.05.04 is
Release Manager: Jonathan Druart
Release Manager assistants:
QA Manager: Katrin Fischer
QA Team:
Topic Experts:
Bug Wranglers:
Packaging Managers:
Documentation Manager: Caroline Cyr La Rose
Documentation Team:
Translation Managers:
Release Maintainers:
We thank the following individuals who contributed patches to Koha 21.05.04
We thank the following libraries, companies, and other institutions who contributed patches to Koha 21.05.04
We also especially thank the following individuals who tested patches for Koha
We regret any omissions. If a contributor has been inadvertently missed, please send a patch against these release notes to koha-devel@lists.koha-community.org.
The Koha project uses Git for version control. The current development version of Koha can be retrieved by checking out the master branch of:
The branch for this version of Koha and future bugfixes in this release line is (HEAD detached from c373fda8931).
Bug reports and feature requests can be filed at the Koha bug tracker at:
He rau ringa e oti ai. (Many hands finish the work)
Autogenerated release notes updated last on 23 Sep 2021 14:41:32.