# Installing XOOPS

## First time installation

### Preface:

XOOPS is an open-source Object-Oriented Web publishing system written in PHP. It is an ideal tool for developing small to large dynamic community websites, intra company portals, corporate portals, weblogs and much more.

XOOPS is released under the terms of the GNU General Public License (GPL) version 2 or greater, and is free to use and modify. It is free to redistribute as long as you abide by the distribution terms of the GPL.

## Requirements

- WWW Server (Apache, NGINX, IIS, etc)
- PHP 5.6.0 or higher, 7.4+ recommended
- MySQL 5.6 or higher, MySQL 8.0+ recommended

### Before you install

1. Setup WWW server, PHP and database server properly.
2. Prepare a database for your XOOPS site.
3. Prepare user account and grant the user the access to the database.
4. Make the directories and the files writable: %s
5. For security considerations, you are strongly advised to move the two directories below out of document root and change the folder names: %s
6. Create (if not already present) and make the directories writable: %s
7. Turn cookie and JavaScript of your browser on.

## Installing locally

If you are 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) to the root document path of your web environment. Once the files are copied there, you can start the install by pointing you browser to "http://yoursite.com". This will start the install process.

## Installing on a hosted platform

If you are running in a hosted environment, unpack the XOOPS files locally or on the server if you have shell (i.e. SSH) access. Once done, 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 pointing you browser to "http://yoursite.com". This will start the install process.

## Continuing the install

Just follow step-by-step instructions in installer.