System requirements and recommendations

General

Koha version

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

OS version

We recommend using the following OS 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 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 23.11

Operating system:

• Debian 12
• Debian 11
• Debian 10
• Ubuntu 22.04
• Ubuntu 20.04

Database:

• MariaDB 10.6
• MariaDB 10.5
• MariaDB 10.3

Search engine:

• Zebra
• ElasticSearch 8.x
• ElasticSearch 7.x
• OpenSearch 2.x
• OpenSearch 1.x

• ElasticSearch 6.x is no longer supported

Perl:

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

Koha 23.05

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

Operating system:

• Debian 12
• Debian 11
• Debian 10
• Ubuntu 22.04
• Ubuntu 20.04

Database:

• MariaDB 10.6
• MariaDB 10.5
• MariaDB 10.3

Search engine:

• OpenSearch 1.x
• ElasticSearch 6.x
• ElasticSearch 7.x
• Zebra

Perl:

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

Koha 22.11 (LTS)

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

Operating system:

• Debian 12
• Debian 11
• Debian 10
• Ubuntu 22.04
• Ubuntu 20.04

Database:

• MariaDB 10.6
• MariaDB 10.5
• MariaDB 10.3

Search engine:

• OpenSearch 1.x
• ElasticSearch 6.x
• ElasticSearch 7.x
• Zebra

Perl:

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

Koha 22.05

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

Operating system:

• Debian 12
• 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:

• OpenSearch 1.x
• ElasticSearch 6.x
• ElasticSearch 7.x
• 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 12
• 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:

• OpenSearch 1.x
• 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

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:

• OpenSearch 1.x
• ElasticSearch 6.x
• ElasticSearch 7.x
• Zebra

Perl:

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

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.