Installing XOOPS
First time installation
Preface:
Before begining the install process, we (the XOOPS team) ask that you have a good understanding of how to install and support server/hosted based software. As with anything in life, there's no easy answer or way. Sinice XOOPS is server based, it's not as easy to install as normal desktop software which in itself can be daunting to install so, please be familiar with setting up and installing the software listed below. Be familiar with how to configure CGI scripts and HTTP server software. It can easily be demonstrated that 80% of our support questions wind up being improper configurations with the server componenets or two pieces of software conflict. No two servers are configured alike.
To install XOOPS for the first time, you'll need to have the minimum following server software pre-installed:
* Web Server: Any server supporting the required PHP version (
Apache highly recommended)
*
PHP: Any PHP version >= 4.3 (PHP 4.2.x may work but is not officially supported)
*
MySQL: MySQL server 3.23+
Before starting the install, be sure to have:
* Setup the HTTP, PHP and database server properly.
* Create a database for your
XOOPS installation
(Have your hosting company create one if you can't. The install script does provide this capability with the proper privileges).
* A user account with the proper database permissions.
* The ability to set the following directories and files world writeable: uploads/, cache/ and templates_c/ and the file mainfile.php
* Turn cookie and JavaScript support in your browser on.
Installing locally
If your running a local environment for development or testing, make sure that you have the previous requirements met. Once this is done, copy the contents of the htdocs directory (from the XOOPS distribution file or SVN) to the root document path of your web environment. Once the files are copied there, you can start the install by typing
http://yoursite.com. This will start the install process.
Installing on a hosted platform
If your running in a hosted environment, unpack the XOOPS files locally or on the server if you have telnet or SSH access. Once you done this, make sure to move or copy all XOOPS files from the htdocs directory to your root web directory (your provider usually provides this location with directions). Once the files are copied there, you can start the install by typing
http://yoursite.com. This will start the install process.
Continuing the install
To be updated according to new installer.