31 Jan 2022
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.09 can be downloaded from:
Installation instructions can be found at:
Koha 21.05.09 is a bugfix/maintenance release with security fixes.
It includes 9 security fixes, 26 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
[29464] GET /acquisitions/orders doesn't honour sorting
Sponsored by ByWater Solutions
[29457] Fee Cancellation records the wrong manager_id
Prior to this patch inadvertently the field borrowers.userid was used to fill accountslines.manager_id. This should have been borrowernumber.
This report fixes that and prints a generic warning.
[29381] Auto-renewal digest messages are sent on every cron run
This fixes an issue with automatic renewal digest messages - these were being sent on every cron run, even if there was nothing to renew or no renewal errors.
(This error was caused by a regression in 21.05 from Bug 18532: Add individual issues to digest notice and hide auto_renewals messaging preference when not needed.)
[29018] Deleting patrons from REST API doesn't do any checks or move to deletedborrowers
These fixes the REST API route for deleting patrons so that it now checks for guarantees, debts, and current checkouts. If any of these checks fail, the patron is not deleted.
[24866] Display budget hierarchy in the budget dropdown menu used when placing a new order
This improves the display for selecting a fund when placing a new order in acquisitions. It now displays as a hierarchy instead of a list without any indentation, for example:
Budget 2021 -- Book -- -- Adult fiction
[29557] Auto renew notices should handle failed renewal due to patron expiration
This enhancement updates the default auto-renewal notices to tell patrons that their renewals have failed because their account has expired.
[17127] Can't hide MARC21 500 and others with NotesToHide
This fixes hiding notes fields (5XX in MARC21 and 3XX in UNIMARC) using NotesToHide. Before this you could hide one field and it worked. However, when hiding multiple fields one field would still always be visible. Now hiding notes fields works as expected.
[29530] When NumSavedReports is set, show value in pull down of entries
This updates the way the NumSavedReports preference value is used on the saved reports page. For the "Show" dropwdown list:
- it now displays the number set in NumSavedReports (previously it showed 20)
- when expanded it now shows the number set in NumSavedReports sequentially (for example, if NumSavedReports is 78, the menu options should be "10, 20, 50, 78, 100, All"), and
- it now displays 'All' if NumSavedReports is blank.
It also updates the description for the NumSavedReports preference to clarify that all reports are shown when no value is entered.
[29571] Mainpage : "All libraries" pending suggestions are visible only if the current library has suggestions
This fixes the display of pending suggestions in the staff interface so that it now shows pending suggestions for all libraries, for example: "Suggestions pending approval: Centerville: 0 / All libraries: 1.". Previously suggestions pending approval was only shown if there were suggestions for the user's current library.
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.09 is
Release Manager: Fridolin Somers
Release Manager assistants:
QA Manager: Katrin Fischer
QA Team:
Topic Experts:
Bug Wranglers:
Packaging Manager:
Documentation Manager: David Nind
Documentation Team:
Translation Managers:
Wiki curators:
Release Maintainers:
We thank the following libraries, companies, and other institutions who are known to have sponsored new features in Koha 21.05.09
We thank the following individuals who contributed patches to Koha 21.05.09
We thank the following libraries, companies, and other institutions who contributed patches to Koha 21.05.09
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 rmain2105.
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 31 Jan 2022 17:38:56.