[cvs] [Wiki] changed: FAQ/Admin/Config

[Jan Schneider]

jan  Sun, 22 May 2005 03:46:27 -0700

Modified page: http://wiki.horde.org/display.php?page=FAQ%2FAdmin%2FConfig
New Revision:  1.1

@@ -1 +1,116 @@
++ Horde Administrator's FAQ
+
+++ Configuration and Operation
+
+[[toc]]
+
++++ General configuration
+
+++++ How can I have Horde in a different directory than /horde/?
+There are usually two changes that people want to make as to how the URL to a Horde component appears in the browser. If only offering one component -- say, IMP -- then one often wants to have a url of
+
+<code>
+http://webmail.example.com/
+</code>
+
+instead of
+
+<code>
+http://webmail.example.com/horde/imp/
+</code>
+
+If offering multiple Horde components -- say, IMP and Troll -- one often wants to have
+
+<code>
+http://horde.example.com/mail/
+</code>
+
+and
+
+<code>
+http://horde.example.com/usenet/
+</code>
+
+instead of the longer versions with the {{/horde/}} component.
+
+To make a single Horde component appear at the root directory of the webserver, add aliases to your webserver's configuration file for the {{/horde/}} directory, and make the {{/horde/componentname/}} the server's document root, and restart your web server.
+
+For example, to make IMP appear at the root directory with Apache, add the following to the {{httpd.conf}}:
+
+<code>
+Alias /horde/ /usr/local/apache/htdocs/horde/
+Alias /imp/   /usr/local/apache/htdocs/horde/imp/
+DocumentRoot  /usr/local/apache/htdocs/horde/imp
+</code>
+
+(substituting your own directory names for the defaults above). Then, make sure links within Horde are correct as follows:
+
+**[Horde 1.2]:** Modify the following variables in {{/horde/config/horde.php3}}:
+
+<code type="php">
+$default->horde_root_url      = '/horde';
+$default->horde_graphics_url  = $default->horde_root_url . '/graphics';
+$default->horde_include_dir   = './templates';
+</code>
+
+Note that the above are relative to the URL, not to the filesystem; the alias we added to the webserver will ensure that /horde works for anything not included in the component (such as problem reporting).
+
+Lastly, configure the Horde component (e.g. IMP) to be at the root of the webserver.
+
+**[IMP 2.x]:** Modify the following values in the file {{/horde/imp/config/defaults.php3}}:
+
+<code type="php">
+$default->root_url      = '';
+$default->graphics_url  = $default->root_url . '/graphics';
+$default->include_dir   = './templates';
+</code>
+
+Note that the {{root_url}} is the empty string {{''}}, and is NOT {{'/'}}!
+
+**[IMP 3.x]:** Modify the {{$this->applications['imp']}} array in {{horde/config/registry.php}} and change the value of the webroot as follows:
+
+<code type="php">
+'webroot' => '/imp',
+</code>
+
+With the above settings, going to
+
+<code>
+http://yourserver.example.com/
+</code>
+
+will take the user right to the IMP login screen.
+
+In the case where one wants to run more than one Horde component but omit the {{/horde/}} part of the URL, configure the webserver to treat the {{/horde/}} directory as the root document directory, and add an alias to make sure links into it still succeed. In Apache:
+
+<code>
+Alias /horde/ /usr/local/apache/htdocs/horde/
+DocumentRoot /usr/local/apache/htdocs/horde
+</code>
+
+(substituting directory names as appropriate).
+
+**[Horde 1.x]:** Configure the file {{/horde/config/horde.php3}} as above, and configure the root URL of the component ({{/horde/component/config/defaults.php3}}) as follows:
+
+<code type="php">
+$default->root_url      = '/componentdir';
+$default->graphics_url  = $default->root_url . '/graphics';
+$default->include_dir   = './templates';
+</code>
+
+replacing componentdir with the name of the directory containing the component. Users will then be able to access components at URLs like
+
+<code>
+http://yourhost.example.com/imp/
+http://yourhost.example.com/troll/
+</code>
+
+**[Horde 2.x]:** For Horde 2.x and it's components, modify the file {{/horde/config/registry.php}} in a similar way. At a minimum, you will need to change the horde application stanza, changing the webroot entry from {{'horde'}} to {{''}} (the empty string, not {{'/'}}).
+
+Finally, modify the file {{horde/config/conf.php}} to change the cookie path from {{'/horde'}} to {{'/'}} as in:
+
+<code type="php">
+$conf['cookie']['path'] = '/';
+</code>
+