System requirements and recommendations

General

Koha version

We recommend using the latest version of the 'stable', 'oldstable' or 'oldoldstable' series for production use.

ElasticSearch version

We recommend using ElasticSearch v6.
ElasticSearch v7 and OpenSearch v1 are being tested, and are currently passing build tests.

OS version

We recommend using the following OS releases for production use:

• Debian AMD64 current 'stable' release (bullseye)
• Ubuntu AMD64 last LTS release (focal)

We aim to support all supported Koha releases on all supported AMD64 Debian/Ubuntu releases.

https://wiki.debian.org/LTS
https://wiki.ubuntu.com/Releases

We recommend not running Koha on i386/32-bit Ubuntu.
Koha is reported to work on i386 and ARM64 platforms, but we are not currently testing them.

Koha 22.05

Koha is continuously tested against the following configurations and as such these are the recommendations for deployment:

Operating system:

• Debian 11
• Debian 10
  
• Ubuntu 22.04
• Ubuntu 20.04
• Ubuntu 18.04

Database:

• MariaDB 10.6
• MariaDB 10.5
• MariaDB 10.3
• MariaDB 10.1

Search engine:

• ElasticSearch 6 (ElasticSearch 7 and OpenSearch are now passing build tests)
• Zebra

Perl:

• Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.

Koha 21.11

Koha is continuously tested against the following configurations and as such these are the recommendations for deployment:

Operating system:

• Debian 11
• Debian 10
• Ubuntu 22.04
• Ubuntu 20.04
• Ubuntu 18.04

Database:

• MariaDB 10.6
• MariaDB 10.5
• MariaDB 10.3
• MariaDB 10.1

Search engine:

• ElasticSearch 6 (ElasticSearch 7 and OpenSearch are now passing build tests)
• Zebra

Perl:

• Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.

Koha 21.05

Koha is continuously tested against the following configurations and as such these are the recommendations for deployment:

Operating system:

• Debian 11
• Debian 10
• Ubuntu 22.04
• Ubuntu 20.04
• Ubuntu 18.04

Database:

• MariaDB 10.6
• MariaDB 10.5
• MariaDB 10.3
• MariaDB 10.1

Search engine:

• ElasticSearch 6 (ElasticSearch 7 and OpenSearch are now passing build tests)
• Zebra

Perl:

• Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.

Unsupported Koha versions

Koha 20.11

Koha is continuously tested against the following configurations and as such these are the recommendations for deployment:

Operating system:

• Debian 11
• Debian 10
• Ubuntu 21.04
• Ubuntu 20.04
• Ubuntu 18.04

Database:

• MariaDB 10.3
• MariaDB 10.1

Search engine:

• ElasticSearch 6
• Zebra

Perl:

• Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.

Koha 19.11

Koha is continuously tested against the following configurations and as such these are the recommendations for deployment:

Operating system:

• Debian 11
• Debian 10
• Ubuntu 21.04
• Ubuntu 20.04
• Ubuntu 18.04

Database:

• MariaDB 10.3
• MariaDB 10.1

Search engine:

• ElasticSearch 6
• Zebra

Perl:

• Perl >= 5.14 is required and versions shipped with the above operating systems are recommended.

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.