Katipo Project Survival Kit

Koha 3.2.0 Now Available

22 October 2010

Koha 3.2.0 is a major feature release and is now available for download and use.

Galen Charlton, release manager, is pleased to announce the release of Koha 3.2.0

The package can be retrieved from:


You can use the following checksum and signature files to verify the download:




Koha 3.2.0

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 http://koha-community.org/

Koha 3.2.0 can be downloaded from:


Installation instructions can be found at:


Koha 3.2.0 is a major feature release.

New features in 3.2.0


The acquisitions module is significantly revamped:

  • Support for hierarchical funds and budgets
  • Budget planning by calendar and item type
  • Vendor contract periods
  • Generation of PDF purchase orders
  • Ability to place orders on a batch of bibliographic records imported into the catalog from a file or Z39.50 search


  • Significant usability enhancements to the system preferences editor
  • Granular permissions are now always on; the GranularPermissions system preference is consequently removed
  • Many additional granular permissions are added


  • Bulk item editing
  • Revamped inventory/stock-taking
  • Ability to export bibliographic information in CSV format from the staff cart
  • New quick spine label print button
  • Support for temporary location and in-process item statuses
  • Usability enhancements to cataloging workflow:
  • Can now choose whether to edit items after saving a bib record
  • Option to move an item from one bib to another
  • Option to delete all items attached to a bib
  • Ability to clone an item
  • View bib in OPAC link from the staff interface
  • Ability to merge duplicate bibliographic record from the staff lists interface


  • Ability to define library transfer limits
  • Email checkout slips
  • Option to enable alert sounds during checkin and checkout
  • Improvements in Koha's ability to express circulation policies
  • Option to charge fines using suspension days instead of money
  • Hold policies are now on the library/itemtype/categorycode level
  • Renewal policies are now on the library/itemtype/categorycode level
  • Ability to specify an expiration date for a hold request when placing it via the staff interface or OPAC
  • Daily batch job to cancel expired holds
  • Improvements to the interface to change the priority of hold requests for a bib in the staff interface
  • New messaging system for patron records, allowing an unlimited number of patron notes to be stored and managed
  • Changes to web-based self checkout
  • Ability to login in automatically to self-check, allowing for unattended self-check stations
  • Ability to display the patron image in self-check


  • Numerous enhancements to the bib display XML templates
  • Per-patron OPAC search history, with ability for patrons to manage the retention of their search history
  • Support for Syndetics, LibraryThing, and Babeltheque enhanced content
  • Support for RIS and BibTeX export
  • Bib details page includes which lists a bib belongs to
  • Can now customize the 'search for this title in' links
  • Preference to control whether patrons can change their details in the OPAC
  • OPAC icon set provided by vokal


  • Guided reports can now take runtime parameters
  • Can now edit SQL reports


  • Can now specify the subscription end date, library location, and grace periods
  • Option to automatically place hold requests for members of a serials routing list
  • Numerous bugfixes

Staff Interface

  • The cart has been added to the staff interface
  • Staff can add items to lists in bulk from search results
  • Enhanced patron card and item label creator
  • Support for XSLT templates in the staff bib details display
  • Bib details page includes which lists a bib belongs to

Web Services and Interface

  • Integration with SOPAC, including support for various web services defined by the ILS-DI recommendation
  • Support for CAS single sign-on
  • Improvements to OAI-PMH support


  • New initialization SQL files for German, Italian, and Polish
  • Revamped UNIMARC framework for English

Internals and Packaging

  • Koha is now packaged for Debian Squeeze; installation of Koha can now be as simple as apt-get install koha
  • Improvements to the management of required Perl modules
  • Improvements to test case coverage
  • Substantial progress on enabling the warnings pragma in all of Koha's Perl code


  • Approximately 1,050 tracked bugs and enhancement requests are addressed in this release

System Preferences

The following system preferences are new in 3.2.0:

  • AcqCreateItem
  • AllowAllMessageDeletion
  • AllowHoldDateInFuture
  • AllowHoldPolicyOverride
  • AutoSelfCheckAllowed
  • AutoSelfCheckID
  • AutoSelfCheckPass
  • BranchTransferLimitsType
  • Babeltheque
  • casAuthentication
  • casLogout
  • casServerUrl
  • ceilingDueDate
  • CurrencyFormat
  • DisplayClearScreenButton
  • DisplayMultiPlaceHold
  • DisplayOPACiconsXSLT
  • EnableOpacSearchHistory
  • FilterBeforeOverdueReport
  • HidePatronName
  • ILS-DI
  • ILS-DI:AuthorizedIPs
  • ImageLimit
  • InProcessingToShelvingCart
  • intranetbookbag
  • LibraryThingForLibrariesEnabled
  • LibraryThingForLibrariesID
  • LibraryThingForLibrariesTabbedView
  • NewItemsDefaultLocation
  • numReturnedItemsToShow
  • OAI-PMH:ConfFile
  • OpacAddMastheadLibraryPulldown
  • OPACAllowHoldDateInFuture
  • OPACAmazonReviews
  • OPACDisplayRequestPriority
  • OPACFineNoRenewals
  • OPACFinesTab
  • OPACPatronDetails
  • OPACSearchForTitleIn
  • opacSerialDefaultTab
  • OPACSerialIssueDisplayCount
  • OPACShowCheckoutName
  • OrderPdfFormat
  • OverdueNoticeBcc
  • OverduesBlockCirc
  • PrintNoticesMaxLines
  • ReturnToShelvingCart
  • RoutingListAddReserves
  • ShowPatronImageInWebBasedSelfCheck
  • soundon
  • SpineLabelAutoPrint
  • SpineLabelFormat
  • SpineLabelShowPrintOnBibDetails
  • StaffSerialIssueDisplayCount
  • SyndeticsAuthorNotes
  • SyndeticsAwards
  • SyndeticsClientCode
  • SyndeticsCoverImages
  • SyndeticsCoverImageSize
  • SyndeticsEditions
  • SyndeticsEnabled
  • SyndeticsExcerpt
  • SyndeticsReviews
  • SyndeticsSeries
  • SyndeticsSummary
  • SyndeticsTOC
  • UseBranchTransferLimits

System requirements

Changes since 3.0:

  • The minimum version of Perl required is now 5.8.8.
  • There are a number of new Perl module dependencies.
    Run ./koha_perl_deps.pl -u -m to get a list of any new modules to install during upgrade.


The structure of the acquisitions tables have changed significantly from 3.0.x. In particular, the budget hierarchy is quite different.

During an upgrade, a new database table is created called fundmapping that contains a record of how budgets were mapped. It is strongly recommended that users of Koha 3.0.x acquisitions carefully review the results of the upgrade before resuming ordering in Koha 3.2.0.


As of Koha 3.2, the Koha manual is now maintained in DocBook. The home page for Koha documentation is


As of the date of these release notes, several translations of the Koha manual are available:

English: http://koha-community.org/documentation/3-2-manual/

Spanish: http://koha-community.org/documentation/3-2-manual-es/

French: http://koha-community.org/documentation/3-2-manual-fr/

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:

  • Chinese
  • Danish
  • English (New Zealand)
  • English (USA)
  • French (France)
  • French (Canada)
  • German
  • Greek
  • Hindi
  • Italian
  • Norwegian
  • Portuguese
  • Spanish
  • Turkish

Partial translations are available for various other languages.

The Koha team welcomes additional translations; please see http://www.kohadocs.org/usersguide/apb.html for information about translating Koha, and join the koha-translate list to volunteer:


The most up-to-date translations can be found at http://translate.koha.org/

Revision control notes

The Koha project uses Git for version control. The current development version of Koha can be retrieved by checking out the master branch of git://git.koha-community.org/koha.git

The branch for Koha 3.2.x (i.e., this version of Koha and future bugfix releases) is 3.2.x.

The next major feature release of Koha will be Koha 3.4.0.

Bugs and feature requests

Bug reports and feature requests can be filed at the Koha bug tracker at http://bugs.koha-community.org/

More Information

More information about the Koha 3.2.0 release can be found at http://koha-community.org/koha-3-2-0/