XOOPS Manual Installation

In this tutorial we will show you how to install Xoops manually. Before you start, there are a few things that you will need to prepare. First create a new MySQL database logins. Those will be used by Xoops to access the MySQL server. You can easily create a new MySQL database using cPanel > MySQL Database Wizard. You can see detailed instructions how to create new MySQL database here:


The second thing you will need to do is download the Xoops installation files. You can download the files from their official website at:


When you download the Xoops archive, extract in your local computer. You will have a new folder called xoops 2.x.x depending on which version you have downloaded. In that folder you will find a folder named “htdocs”:


You will need to upload the content of that folder to the directory in your hosting, where you wish to install Xoops. If you want to access the site using , you should upload the files in /public_html/, if you want to access the site using , upload the files in: /public_html/cms/. To upload the files you can use an FTP client. You can review our FTP video tutorials at:

For the purpose of this tutorial, we assume that you have uploaded the Xoops files in the /public_html/ directory. To start the installation process simply go to:

This will bring the installation screen for Xoops:

Lang Choose

Click on the “Next” button on that page. Now on the next page Xoops will ask you to create a MySQL database and setup the folders for your Xoops installation. You have already done so in the beginning of this tutorial. The only thing you may consider is moving the xoops_lib and xoops_data directories outside of your web root directory. This measure is required for security reasons:


Proceed to the next page. Xoops will check the server configuration. Everything should be OK in here:


You can proceed to the next page. The script will find the path to your website as well as your site URL. Check if they are detected correctly and fix them only if needed:

Directory set

The next thing you will need to do is enter your database details. Use the ones that you created in the beginning of this tutorial:

DataBase Set

Proceed further and enter the name of the database that you created:

Database set 2

Xoops will inform you that the changes have been saved in the mainfile.php and secure.php file:

System Config save

Go to the next step. Xoops will create the MySQL database tables:

Tables enroll

After that you can create your administrative user details:

Admin Login – choose your administrative username

Admin e-mail – make sure to use a valid email address as you may need it in the future

Admin password

Admin Details

Proceed to the next step where you can configure your site details:

Site Name

Slogan For your site

Meta Keywords – these words are used for SEO purposes

Meta description

Meta Author

Allow new user registrations

Site Details

Now select your site theme:

Theme Select

After that you can select the modules that you wish to have pre-installed:

Installed Modules

That’s it! You have successfully installed Xoops:

Success Install

Note: For security reasons, make sure to remove the “install” folder which has been renamed after the installation.