######################################################################
##             Install instructions for Mambo 4.5                   ##
##                   Created: March 16th, 2004                      ##
######################################################################

======================================================================
# Getting started #
======================================================================
First you must have the base environment for Mambo Open Source (MOS).
We have thoroughly tested MOS on: Linux, Free BSD, Mac OS X and Windows NT/2000.
Linux or one of the BSD's are recommended, but anything else that can run the
3 pieces of software listed below should do it.

Apache Web server http://www.apache.org
MySQL Database http://www.mysql.com
PHP HTML-embedded scripting language.  http://www.php.net

You MUST ensure that PHP has been compiled with support for MySQL and Zlib 
in order to successfully run MOS.

While we have reports that Mambo works on IIS server we recommend Apache
for running Mambo on Windows.

======================================================================          	
# Getting Mambo #                                                              	
======================================================================          	
You will find the latest version at
http://sourceforge.net/projects/mambo or
http://mosforge.net/projects/mambo

======================================================================
# Installing Mambo #
======================================================================
First you must unpack it.
You can run MOS as a full site e.g. http://www.mysite.com, 
or you can run it in a subdirectory of another site e.g.

http://www.mysite.com/mambo/.

In this example it will run in the root of a web site:

MOS is packaged in gzip and tar format. Untar or using Winzip uncompress the
distribution file into the directory your created above e.g. 

tar -xvfz latest_mambo_version.tar.gz -C

(Make sure you have a trailing slash and replace latest_mambo_version with the
version you have downloaded). 

Alternatively if you downloaded the file to your computer and unpacked it
locally use a FTP program to upload all files to your server.
Make sure all PHP, CSS and JS files are sent in ASCII mode and images in BINARY mode.

Now you have to create a database for Mambo in MySQL,
If you already have a database ready you can skip this part.

Use the mysqladmin command:
mysqladmin -uroot -ppassword create mambo_database_name

Alternatively you can use your web control panel or phpMyAdmin to create a
database for Mambo.

Finally point your web browser to http://www.mysite.com where the Mambo web
based installer will guide you through installation.

======================================================================
# Manual Installation #
======================================================================

If you by some reason can't use web installer you can also install Mambo
manually.
The manual installation guide can be found here:
http://mosdoc.mamboserver.com/wakka.php?wakka=Manual_Install_Guide&v=1buz
