HORDE Installation Guide
Copyright 1998,1999 Charles J. Hagenbuch <chuck@horde.org>
Copyright 1999 Ivan E. Moore II <rkrusty@tdyc.com>

This code is licensed under the GNU Public License.
See the file COPYING in this directory.

Last Updated: 04/03/99 


---------------------- 
Requirements for HORDE
======================


 * php 3.0.7 or greater 
 * a web server, preferably an SSL web server so that HORDE Modules can use a 
     secure connection.
 * PERL if you want to use the config scripts.



-----------------------
Methods of Installation
=======================


             Currently there is one way to configure HORDE out of the box,
        and that's manually.  If you install the IMP module as well, you
        have a couple new options.  (Please see the INSTALL file that comes
        with IMP for more information).



-=-=-=-=
Manually
-=-=-=-=


              The most common method of installing HORDE is to grab the tarball,
          untar it somewhere and run through the code making all the changes 
          you need by hand.  

          Here is the process for doing all of this by hand.

           1)  obtain horde*.tar.gz 

           2)  untar/gzip it into the directory you want.

               You should now have a directory structure is like this:

                  horde/
                  horde/lib
                  horde/lib/src
                  horde/lib/src/...[lots of sub dir's]
                  horde/db
                  horde/config
                  horde/templates
                  horde/locale
                  horde/scripts
                  horde/docs

           3) go into horde/lib/src and run the following command:

                  ./build.pl

              If you install IMP as well, you can use the setup.php3 process
          that comes with it to configure the HORDE libraries as well.
       
           4) In horde/config you will find a few files.  

                [...insert config info here...]

           5) You now need to configure any modules you have installed. Please
              see their respective INSTALL files for more details.
          



-=-=-=-=
Packages
-=-=-=-=


                Packages are by far the easiest way to install any program.  
           The reason I say this is because most of the work is done for you.
           By the use of scripts the maintainer of the package take care of
           most configuration issues and the program because (most of the time)
           pretty much plug and play.   

                Currently there are 2 types packaging out there in use.
           (there are probably more but these are teh ones I know of).
           They are:  RPM (RedHat Package Management) which has a 
           .rpm extension, and Debian Package format which  has a .deb
           extension.

               There is currently a Debian package being maintained by Ivan  
           Moore II.  It is available from http://snowcrash.tdyc.com/debian.php3
           and is also available within the Debian distribution.  This
           package takes care of most configuration issues and still allows you
           to customize your HORDE installation. This package also detects 
           Postgres and MySql installations and will automagically configure
           either for use with HORDE. After installing this package you will
           have a functional HORDE installation.

		Currently there is no RPM package. If you are interested in
	   maintaining one, please get in touch with us.



-----------------------
Getting Help with HORDE
=======================


There is an online, user-editable FAQ at http://horde.org/faq/. Use it, and
add anything that you run into to it, so that others can benefit from
everything you figure out, and vice versa...

There is a web page for HORDE at http://web.horde.org/. There are also two
mailing lists. One is the general IMP list, for development, discussion,
etc. It is imp@horde.org, and you can subscribe by sending an empty email to
imp-subscribe@horde.org.

The other list is the CVS commits list, and most of the mail on it is
automatically generated announcements of changes to the CVS code. Developers
should definitely be on it, and anyone else who is curious about the status
of IMP development is welcome to join it by sending email to
imp-cvs-subscribe@horde.org.

There are also web archives of both mailing lists. See, respectively:
  http://web.horde.org/mail/imp/
  http://web.horde.org/mail/cvs



=-=-=-=-=-=-
Found A Bug?
=-=-=-=-=-=-

    If you have found a bug you can add it to the Bug Tracking System
we have setup for the HORDE projects.  You can find it at:

http://web.horde.org/bugs

    Please verify that the bug is not already in the database and also
please be as descriptive as possible.  Fill out all the options.  You may
think it's something that affects everyone, but a lot of times it's 
specific to a browser or operating system.  So please be thorough.  In
the case of Bug Tracking, there is never too much information or
documentation.



----------------------------------------------------------------------
We hope you find HORDE useful and easy to use.  We thank you for taking
the time to try it and if you ever have any questions, just ask.

This version of the Installation manual was slapped together in part
by Ivan, Mike, Jason and of course, the man who started it all, the
man who keeps us on our toes, the man who'll probably never notice I
put this here but if he does I'm a dead man...Chuck.

Enjoy,

Chuck Hagenbuch and the IMP team
chuck@horde.org
----------------------------------------------------------------------
