2.4. Ubuntu — Groonga v14.0.6 documentation

Skip to main content
`Ctrl`+`K`

# 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. PPA (Personal Package Archive)

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:

- 20.04 LTS Focal Fossa

- 22.04 LTS Jammy Jellyfish

- 23.04 Lunar Lobster

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

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.

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

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

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

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.2. Build from source

Download source:

    wget https://packages.groonga.org/source/groonga/groonga-13.0.9.tar.gz
    tar xvzf groonga-13.0.9.tar.gz
    cd groonga-13.0.9

Install required packages to build Groonga:

    ./setup.sh

Configure:

    cmake -S . -B build --preset release-with-debug-info-maximum

Build:

    cmake --build build

Install:

    sudo cmake --install build