.. -*- rst -*-

.. highlightlang:: none

Install
=======

This section describes how to install groonga on each environment.

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.


Debian GNU/Linux squeeze
------------------------

/etc/apt/sources.list.d/groonga.list::

  deb http://packages.groonga.org/debian/ squeeze main
  deb-src http://packages.groonga.org/debian/ squeeze main

Install::

  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
  % sudo aptitude update
  % sudo aptitude -V -D -y install groonga

Debian GNU/Linux wheezy
-----------------------

/etc/apt/sources.list.d/groonga.list::

  deb http://packages.groonga.org/debian/ wheezy main
  deb-src http://packages.groonga.org/debian/ wheezy main

Install::

  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
  % sudo aptitude update
  % sudo aptitude -V -D -y install groonga

Debian GNU/Linux sid
--------------------

/etc/apt/sources.list.d/groonga.list::

  deb http://packages.groonga.org/debian/ unstable main
  deb-src http://packages.groonga.org/debian/ unstable main

Install::

  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
  % sudo aptitude update
  % sudo aptitude -V -D -y install groonga

Ubuntu 10.04 LTS Lucid Lynx
---------------------------

.. note::

   You'll need to enable the universe repository of Ubuntu to install groonga.
   The following describes how to do it.

/etc/apt/sources.list.d/groonga.list::

  deb http://packages.groonga.org/ubuntu/ lucid universe
  deb-src http://packages.groonga.org/ubuntu/ lucid universe

Install::

  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
  % sudo aptitude update
  % sudo aptitude -V -D -y install groonga

Ubuntu 11.04 Natty Narwhal
--------------------------

.. note::

   You'll need to enable the universe repository of Ubuntu to install groonga.
   The following describes how to do it.

/etc/apt/sources.list.d/groonga.list::

  deb http://packages.groonga.org/ubuntu/ natty universe
  deb-src http://packages.groonga.org/ubuntu/ natty universe

Install::

  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
  % sudo aptitude update
  % sudo aptitude -V -D -y install groonga

Ubuntu 11.10 Oneiric Ocelot
---------------------------

.. note::

   You'll need to enable the universe repository of Ubuntu to install groonga.
   The following describes how to do it.

/etc/apt/sources.list.d/groonga.list::

  deb http://packages.groonga.org/ubuntu/ oneiric universe
  deb-src http://packages.groonga.org/ubuntu/ oneiric universe

Install::

  % sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 1C837F31
  % sudo aptitude update
  % sudo aptitude -V -D -y install groonga

CentOS 5
--------

Install::

  % sudo rpm -ivh http://packages.groonga.org/centos/groonga-repository-1.0.0-0.noarch.rpm
  % sudo yum update
  % sudo yum install -y groonga

CentOS 6
--------

Install::

  % sudo rpm -ivh http://packages.groonga.org/centos/groonga-repository-1.0.0-0.noarch.rpm
  % sudo yum update
  % sudo yum install -y groonga

Fedora 15
---------

Install::

  % sudo rpm -ivh http://packages.groonga.org/fedora/groonga-repository-1.0.0-0.noarch.rpm
  % sudo yum update
  % sudo yum install -y groonga

Mac OS X (MacPorts)
-------------------

Install::

  % sudo port install groonga

Mac OS X (Homebrew)
-------------------

Install::

  % brew install groonga

Windows (Installer)
-------------------

You just download an installer (.exe file) from
`packages.groonga.org/windows/ <http://packages.groonga.org/windows/groonga/>`_
and execute it.

Windows (zip)
-------------

You just download a zip file from
`packages.groonga.org/windows/ <http://packages.groonga.org/windows/groonga/>`_
and extract it.

Others
------

If you want to use a morphological analyzer for tokenization in full-text indexing, please install `MeCab <http://mecab.sourceforge.net/>`_ before installing groonga.

Then, download a tar.gz file from `packages.groonga.org/source/ <http://packages.groonga.org/source/groonga/>`_ and extract it. After that, please run the following command to install groonga.

Install::

 ./configure --prefix=/usr --localstatedir=/var && make && sudo make install

The "prefix" option specifies the path to install groonga. If you don't specify the install path, "/usr/local" is used. Please specify "/usr" if you are not familiar with environment variables such as LD_LIBRARY_PATH.
