===============================================
 Install IMP Webmail, Ingo Mail Filter Manager
===============================================

This will install a set of applications for Webmail.

- IMP Webmail
- Ingo Mail Filer Manager
- `ActiveSync`_

.. _`ActiveSync`: https://wiki.horde.org/ActiveSync?referrer=Doc%2FDev%2FH6%2FInstallation%2FInstallAppsMail

----------------------
 Install applications
----------------------

Inside your Root Project, run

::

 sudo -u www-data composer require horde/imp ^7 horde/ingo ^4 horde/activesync ^3

The general pattern is
composer require horde/$app $version

Use the caret ^ character to pin to a major version. Use the tilde ~ to pin to a major and minor version. Use a fully qualified version name to pin to an exact version. This is normally not recommended. See the composer documentation for more advanced requirements. See the repo https://packagist.org/ for available versions of individual apps. Note that only the latest major version will currently run with composer.

Warning: As of now, installing apps without a version constraint may result in installing the app from the development branch. This will be changed when the apps are officially released.

-----------------------
 Provide configuration
-----------------------

Put config files into

- var/config/imp
- var/config/ingo
- var/config/activesync

Run the command
::

 sudo -u www-data composer horde-reconfigure

----------------------
 Configure via Web UI
----------------------

Go to the web UI and generate the default configs for the calendar and tasks apps:

/horde/admin/config/config.php?app=imp
/horde/admin/config/config.php?app=ingo
/horde/admin/config/config.php?app=activesync

The content app does not need this.

On a fresh installation, the config UI will try to place the files in the web dir.
This would result in the files vanishing on the next update.
You need to move them to the persistent config dir.

::

 mv web/imp/config/conf.php var/config/imp/conf.php
 mv web/ingo/config/conf.php var/config/ingo/conf.php
 mv web/activesync/config/conf.php var/config/activesync/conf.php
 sudo -u www-data composer horde-reconfigure

For later changes, the config UI should recognize the symlink and edit the target file instead.

Extra config for imp
====================

Put these extra files into var/config/imp/ for customizing your mail backends layout and storage

::

 backends.local.php

Run the 'composer horde-reconfigure' command in the root project dir afterwards.

---------------------------
 Setup the database tables
---------------------------

Run this command:
::

  ./vendor/bin/horde-db-migrate up