Horde/Imp Webmail

This procedure installs the Horde/Imp webmail client.

Note: Imp requires an IMAP server.

1. Login as the root user.
   [screenshot]

2. Install the Apache web server.

   # apt-get install apache

3. Install the Horde 2 framework.

   # apt-get install horde2

   Accept the defaults for all Horde questions:
   [screenshot] What kind of web server are you running? Apache
   [screenshot] What type of preferences container (database) are you running? MySQL
   [screenshot] What is the hostname where your database is running? localhost
   [screenshot] What is the port number to connect to your database? defaultport
   [screenshot] Enter the username of the administrator in the MySQL database? root
   [screenshot] What is your admin database password? [empty]
   [screenshot] What name do you want for your HORDE database? horde2
   [screenshot] What is your database username? hordemgr
   [screenshot] What is the password for the horde user? [empty]

   Answer 'y' if you prompted to run the apacheconfig script, save the configuration changes, or restart Apache.

4. Install the Imp webmail client.

   # apt-get install imp3

   Accept the defaults for all Imp questions:
   [screenshot] Authenticate users with IMP? Yes
   [screenshot] Do you want me to add extension=imap.so? Y

   Imp may depend on Turba. Accept the defaults for all Turba questions, if prompted:
   [screenshot] What is your admin database password? [empty]

5. Set the IMAP namespace.

   # mcedit /etc/imp3/servers.conf
   [screenshot]

   The namespace line must be changed to this:

   'namespace' => 'INBOX.',
   

   Note: This namespace value is peculiar to Courier IMAP. The default value will work with most other IMAP servers.

6. Enable Imp in the Horde registry.

   # mcedit /etc/horde2/registry.d/imp.php
   [screenshot]

   This line must be added to the array block:

   'status' => 'active',
   

7. Enable Turba in the Horde registry.

   # mcedit /etc/horde2/registry.d/turba.php
   [screenshot]

   This line must be added to the array block:

   'status' => 'active',
   

8. Enable the PHP4 mime type in the web server configuration.

   # mcedit /etc/apache/httpd.conf
   [screenshot] What is your admin database password? [empty]

   Uncomment these two lines in the mod_mime section:

   AddType application/x-httpd-php .php
   AddType application/x-httpd-php-source .phps
   

9. Ensure that PEAR is in the Apache include path.

   # mcedit /etc/horde2/apache.conf
   [screenshot]

   If /usr/share/pear is not already part of the include_path, then add it.

   php_value include_path .:/etc/horde2:/usr/share/php:/usr/share/horde2:/usr/share/pear
   

10. Reload the Apache configuration.

    # /etc/init.d/apache reload

11. Test the installation by loading Horde in a web browser.

    http://vmwoody.local/horde2/
    [screenshot]

    Note: Horde requires a working DNS configuration. If frames in the Horde document fail to load, then the DNS configuration is incorrect. The server name must resolve through DNS before Horde will work properly.