2.4. Ubuntu#

This section describes how to install Groonga related deb packages on Ubuntu. You can install them by apt.

We distribute both 32-bit and 64-bit packages but we strongly recommend a 64-bit package for server. You should use a 32-bit package just only for tests or development. You will encounter an out of memory error with a 32-bit package even if you just process medium size data.

2.4.1. Register Groonga APT repository#

2.4.1.1. APT Repository (packages.groonga.org)#

Groonga packages are distributed via our Groonga APT repository at https://packages.groonga.org.

Install groonga-apt-source to enable Groonga APT repository.

sudo apt update
sudo apt install -y -V ca-certificates lsb-release wget
wget https://packages.groonga.org/ubuntu/groonga-apt-source-latest-$(lsb_release --codename --short).deb
sudo apt install -y -V ./groonga-apt-source-latest-$(lsb_release --codename --short).deb
sudo apt update

2.4.1.2. PPA (Personal Package Archive)#

Note

The PPA will be deprecated. We strongly recommend using our Groonga APT repository (packages.groonga.org) because packages from that repository are built with Apache Arrow enabled. This configuration unlocks extra features, such as parallel offline index building.

The Groonga APT repository for Ubuntu uses PPA (Personal Package Archive) on Launchpad. You can install Groonga by APT from the PPA.

Here are supported Ubuntu versions:

  • 22.04 LTS Jammy Jellyfish

  • 24.04 LTS Noble Numbat

Enable the universe repository to install Groonga:

sudo apt -V -y install software-properties-common
sudo add-apt-repository -y universe

Add the ppa:groonga/ppa PPA to your system:

sudo add-apt-repository -y ppa:groonga/ppa
sudo apt update

2.4.2. groonga package#

Install:

sudo apt -V -y install groonga

Note

groonga package is the minimum set of fulltext search engine. If you want to use Groonga for server use, you can install additional preconfigured packages.

There are two packages for server use.

  • Groonga HTTP server (HTTP based server package)

  • groonga-server-gqtp (GQTP based server package)

See Server section about details.

2.4.3. groonga-tokenizer-mecab package#

If you want to use MeCab as a tokenizer, install groonga-tokenizer-mecab package.

Install groonga-tokenizer-mecab package:

sudo apt -V -y install groonga-tokenizer-mecab

2.4.4. groonga-token-filter-stem package#

If you want to use TokenFilterStem as a token filter, install groonga-token-filter-stem package.

Install groonga-token-filter-stem package:

sudo apt -V -y install groonga-token-filter-stem

2.4.5. groonga-munin-plugins package#

There is a package that provides Munin plugins. If you want to monitor Groonga status by Munin, install groonga-munin-plugins package.

Install groonga-munin-plugins package:

sudo apt -V -y install groonga-munin-plugins

2.4.6. groonga-normalizer-mysql package#

There is a package that provides MySQL compatible normalizer as a Groonga plugin. If you want to use that one, install groonga-normalizer-mysql package.

Install groonga-normalizer-mysql package:

sudo apt -V -y install groonga-normalizer-mysql

2.4.7. Build from source#

Build from source is for developers.

See Others: Build with CMake .