System requirements and recommendations
General
Koha version
We recommend using the latest version of the 'stable', 'oldstable', 'oldoldstable', or 'oldoldoldstable' (LTS) releases for production use.
OS version
We recommend using the following operating system releases for production use:
- Debian AMD64 current 'stable' release
- Ubuntu AMD64 last LTS release
We aim to support all supported Koha releases on all supported AMD64 Debian/Ubuntu LTS releases:
We do not recommend running Koha on i386/32-bit Ubuntu - Koha is reported to work on i386 and ARM64 platforms, but we do not test them.
Supported Koha versions
Koha is continuously tested against the listed configuration options for each supported version, and these are recommended for deployment.
Koha 24.11 (stable and next LTS)
Operating system:
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Ubuntu 24.04 (Noble Numbat)
- Ubuntu 22.04 (Jammy Jellyfish)
Database:
- MariaDB 10.6
- MariaDB 10.5
- MariaDB 10.3
Search engine:
- Zebra
- ElasticSearch 8.x
- ElasticSearch 7.x
- Note: We can't test against OpenSearch, so it is not recommended or supported until the issues in Bug 38345 and the development environment issue #429 are fixed.
Perl:
- Perl >= 5.14 is required, and versions shipped with the above operating systems are recommended.
Koha 24.05 (oldstable)
Operating system:
- Debian 12 (Bookworm)
- Debian 11 (Bullseye)
- Ubuntu 24.04 (Noble Numbat)
- Ubuntu 22.04 (Jammy Jellyfish)
Database:
- MariaDB 10.6
- MariaDB 10.5
- MariaDB 10.3
Search engine:
- Zebra
- ElasticSearch 8.x
- ElasticSearch 7.x
- Note: We can't test against OpenSearch, so it is not recommended or supported until the issues in Bug 38345 and the development environment issue #429 are fixed.
Perl:
- Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.
Koha 23.11 (oldoldstable)
Operating system:
- Debian 12
- Debian 11
- Ubuntu 24.04
- Ubuntu 22.04
Database:
- MariaDB 10.6
- MariaDB 10.5
- MariaDB 10.3
Search engine:
- Zebra
- ElasticSearch 8.x
- ElasticSearch 7.x
- Note: We can't test against OpenSearch, so it is not supported until the issues in Bug 38345 and the development environment issue #429 are fixed.
- ElasticSearch 6.x is no longer supported
Perl:
- Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.
Koha 22.11 (oldoldoldstable and LTS)
Operating system:
- Debian 12
- Debian 11
- Debian 10 (tested but end of life, so not recommended)
- Ubuntu 24.04
- Ubuntu 22.04
- Ubuntu 20.04
Database:
- MariaDB 10.6
- MariaDB 10.5
- MariaDB 10.3
Search engine:
- OpenSearch 1.x - currently not able to test against OpenSearch, so it is not supported until the issues in Bug 38345 and the development environment issue #429 are fixed
- ElasticSearch 6.x
- ElasticSearch 7.x
- Zebra
Perl:
- Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.
Unsupported Koha versions
Other versions of Koha are no longer supported, and are not recommended for production.
Libraries should upgrade to a supported version, so that they get monthly maintenance releases with bug fixes and security releases.
Zebra
SRU over HTTPS will only work with YAZ 5.30.3 and up, which is available in Debian 11 (Bullseye) and up as libyaz5.