.. -*- rst -*-

.. highlightlang:: none

Install
=======

We will explain of how to install Groonga for each environments.

We distribute packages for both 32-bit and 64-bit but we recommend that you should use 64-bit package for server. You should use 32-bit package just only for test or development. You will get no memory error with 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 should add universe section in the official Ubuntu
   repository. The following describes how to add 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 should add universe section in the official Ubuntu
   repository. The following describes how to add 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 should add universe section in the official Ubuntu
   repository. The following describes how to add 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 installer (.exe file) from
`packages.groonga.org/windows/ <http://packages.groonga.org/windows/groonga/>`_
and execute it.

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

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

Others
------

If you will use indexes of tokenizing of each morpheme for
full-text search, you should install `MeCab <http://mecab.sourceforge.net/>`_
before you install groonga.

After, you should download tar.gz-file from
`packages.groonga.org/source/ <http://packages.groonga.org/source/groonga/>`_
for installing groonga. You should extract this file in
place to install, and run commands below-mentioned. ::

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

The "prefix" option is the paramater for specified place to install.
If you won't specify the option, "/usr/local" is specified.
Please specify "/usr" for this option if you don't know environment variables(LD_LIBRARY_PATH and so on) well.
