XOOPS, You Can Do It Again and Again

How to set up, install and configure XOOPS, the object-oriented extensible blog and content management system.
XOOPS Installation

Now, we'll assume you have MySQL and Apache/PHP running, so it is time to start with the installation of XOOPS.

Point your Web browser to if you are using your own server. Point it to http://yourdomain/install/index.php if you are using a commercial host.

This should take you to the install screen. See Figure 2 for an example.

Figure 2. The First XOOPS Install Screen

Now, click on the Next button to see a brief introduction, as shown in Figure 3.

Figure 3. XOOPS Introduction Screen

Click on the Next button once again. At this point, it is quite possible you will experience a problem with the permissions (see Figure 4 for an example).

Figure 4. XOOPS reports permission problems during installation.

Here's how to solve these permission problems:

$ chmod 777 uploads/
$ chmod 777 cache/
$ chmod 777 templates_c/
$ chmod 666 mainfile.php

Once you have set the correct permissions, press the Reload button, and you should see that there are no longer permission problems (Figure 5).

Figure 5. No more permission problems for XOOPS.

Press the Next button again. Before we explain how to fill in the next page, you need to create the XOOPS MySQL database and a user name and password for that database. Open a console or an X terminal, and run the following commands:

$ mysqladmin -u mysql -p create xoops4
$ mysql -u mysql -p

In this case, I selected xoops4 for the database name, and I used the default mysql as the MySQL user. You can use these names if you want to, but make sure to remember them. You'll need to fill in this information in a Web page shortly. The second command above logs you in to MySQL and presents you with a MySQL command prompt. Once you see the prompt, type the following command to give the mysql user privileges to the xoops4 database, and set the password:

mysql> GRANT ALL PRIVILEGES ON xoops4.* TO mysql@localhost
--<IDENTIFIED BY 'password';

Now that you've made a database called xoops4, you must replace its password in the command shown as 'password'.

Now, back to the XOOPS Web configuration page. Fill in the correct information. Figure 6 shows the information for our sample installation. Normally, you would fill in the last field with the domain name for your Web server instead of using

Figure 6. Tell XOOPS about the MySQL database, the database user and password as well as other information.

After you click the Next button, you should see a screen that confirms all the information you entered (Figure 7). If everything looks fine, click Next. If something went wrong, go back and modify the information to correct it.

Figure 7. XOOPS Information Confirmation Screen

When you press Next after the confirmation screen, you should see a new screen with the title Saving configuration data (Figure 8). Press the Next button again. XOOPS will check to see if the physical and virtual path to the XOOPS files are correct (Figure 9).

Figure 8. XOOPS tells you the configuration data it saves.

Figure 9. All the paths check out.

Click the Next button again. You should see a Web page that confirms the database settings (Figure 10).

Figure 10. Database settings check out.

Next, XOOPS checks to see if it can connect to the database and modify the database (Figure 11).

Figure 11. XOOPS can connect to and use the database.

Click the Next button once again. Now the XOOPS installer creates all of the MySQL tables it needs (Figure 12).

Figure 12. XOOPS creates all of its own database tables.

Now you need to fill the text boxes with information about the administrator of the XOOPS site (Figure 13). XOOPS will ask you about the Admin name, Email and the password for the Admin account.

Figure 13. Specify the XOOPS Administrator e-mail, user name and password.

Click Next, and XOOPS uses this information to insert some starting data in various XOOPS tables (Figure 14).

Figure 14. XOOPS tells you about initializing data in various tables.

Click the Next button once again and that should get your XOOPS site up and running. You should see a final confirmation screen like the one shown in Figure 15.

Figure 15. Final XOOPS Installation Screen

Press the HERE link to get to the login screen for your site. This is actually what your site looks like when you first start XOOPS. It is obviously bare bones, but that is because you haven't activated any of the XOOPS features yet.

Log in using the administrator user name and password you specified earlier.

Figure 16. Login Screen for Your XOOPS Site