Install Guides

Step 1: Create a database via your hosting control panel, refer to your setup email for login information. If your site does not have a control panel please request a MySQL database setup for your domain by opening a support ticket.

• Log in to your hosting control panel
• Click the Tools link in the navigation
• Click the Database Manager icon
• Create a MySQL database and make note of the database name, user and password

Step 2: Download the latest stable version zip from the XOOPS web site

Step 3: Extract the zip file to a directory on your computer

Step 4: Upload all the files contained in the /htdocs folder you just extracted via FTP to the location on the web root of your site (/www folder in most cases), or a sub folder if you don't want to use XOOPS to manage your home page.

Step 5: Before starting the install some write permissions need to be set. This can be done via the ACL Manager under the Tools link in your hosting control panel, set ReadWriteDelete for the *_web user on the /uploads folder, /cache folder, /templates_c folder and the mainfile.php file. If you do not have a control panel please open a support ticket to request the permission changes.

Step 6: Point a browser to your web site where you uploaded the XOOPS files and follow the installation steps.

Step 7: On the database step use for hostname and fill in the information you noted when creating your database

Step 8: After completing the install steps delete the /install folder from the FTP and set the permissions on the mainfile.php file back to Read via your hosting control panel.

Step 9: It is possible the software admin will display an error claiming it can still write to the configuration file even though permissions for the web user have been set back to Read only. In this case you can do one of the following things to get rid of the error.

• Open the admin.php file in a text editor and comment out the snippet of code that checks the file by putting // before each line.

// if ( is_writable(XOOPS_ROOT_PATH."/mainfile.php" ) ) {
//     xoops_error(sprintf(_WARNINWRITEABLE,XOOPS_ROOT_PATH.'/mainfile.php'));
//     echo '<br />';
// }

• Submit a support ticket asking to change the file properties (not permissions) to Read Only. Keep in mind you will no longer have access to the file at all.

To keep your site and CMS application secure it is important to install software updates as soon as possible! Check with the publisher of the software frequently if any updates are available.

Add Feedback