.. contents:: Contents
.. section-numbering::

==============
 Installation
==============

Horde Groupware requires some prerequisite software before you can use it. In addition, there are other software packages which, while
not required, are recommended as without them you will experience very limited functionality. The following helps you to
install the required and recommended software packages on a Debian Etch (4.0) System.

*There is also a Horde 'Groupware Webmail Edition' this will not be the part of this how to*
*This how to will not cover your mailserver setup.*

*Note: this how to is just a draft and not really perfect - feel free to edit it and make it better*

=================
 Debian specific
=================

I started with a new and fresh Debian(openvz-image)
You should update your system.
::

 apt-get update && apt-get dist-upgrade

====================================
 Install Apache and php and modules
====================================

::

 apt-get install libapache2-mod-php5 apache2 apache2-mpm-prefork


You need the cli for the horde setup script!
::

 apt-get install php5-cli


These php modules are needed for horde Groupware
::

 apt-get install php-pear php5-gd php5-ldap php5-mcrypt php5-memcache 


For webmail you need the imap extension
::

 apt-get install php5-imap


If you want to use mysql as Database backend, you should install the php5-mysql extension
::

 apt-get install php5-mysql


If you want to you postgresql as Database backend install php5-pgsql::

 apt-get install php5-pgsql

==================
 Install Database
==================

For Mysql
::

 apt-get install mysql-server


You will be asked for a mysqlroot password - don't forget it ;)
After that you need to create a user and create grants.
::

 mysql -p -e 'CREATE USER HORDE ...'


::

 mysql -p -e 'grant all on horde.* to horde@localhost identified by "horde";'

=========================
 Install Horde Groupware
=========================

Download and unpack it
::

 wget [tarball]
 cd /root
 tar -xvf horde-webmail-1.0.1.tar.gz

copy to /var/www and change owner
::

 cp -r /root/horde-webmail-1.0.1 /var/www/horde
 chown -r www-data:www-data horde


with php5-cli start the setup script
::

 php5 -q /var/www/horde/scripts/setup.php