.. -*- rst -*-

.. highlightlang:: none

Windows
=======

This section describes how to install Groonga on Windows. You can
install Groogna by extracting a zip package or running an installer.

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.

Installer
---------

For 32-bit environment, download x86 executable binary from
packages.groonga.org:

  * http://packages.groonga.org/windows/groonga/groonga-3.1.0-x86.exe

Then run it.

For 64-bit environment, download x64 executable binary from
packages.goronga.org:

  * http://packages.groonga.org/windows/groonga/groonga-3.1.0-x64.exe

Then run it.

Use command prompt in start menu to run
:doc:`/reference/executables/groonga`.

zip
---

For 32-bit environment, download x86 zip archive from
packages.groonga.org:

  * http://packages.groonga.org/windows/groonga/groonga-3.1.0-x86.zip

Then extract it.

For 64-bit environment, download x64 zip archive from
packages.groonga.org:

  * http://packages.groonga.org/windows/groonga/groonga-3.1.0-x64.zip

Then extract it.

You can find :doc:`/reference/executables/groonga` in ``bin`` folder.

Build from source
-----------------

First, you need to install required tools for building Groonga on
Windows. Here are required tools:

  * `Microsoft Visual Studio 2010 Express
    <http://www.microsoft.com/japan/msdn/vstudio/express/>`_
  * `CMake <http://www.cmake.org/>`_

Download zipped source from packages.groonga.org:

  * http://packages.groonga.org/source/groonga/groonga-3.1.0.zip

Then extract it.

Move to the Groonga's source folder::

  > cd c:\Users\%USERNAME%\Downloads\groonga-3.1.0

Configure by ``cmake``. The following commnad line is for 64-bit
version. To build 32-bit version, use ``-G "Visual Studio 10"``
parameter instead::

  groonga-3.1.0> cmake . -G "Visual Studio 10 Win64" -DCMAKE_INSTALL_PREFIX=C:\groonga

Build::

  groonga-3.1.0> cmake --build . --config Release

Install::

  groonga-3.1.0> cmake --build . --config Release --target Install

After the above steps, :doc:`/reference/executables/groonga` is found in
``c:\groonga\bin\groonga.exe``.