How to install Xoops CMS – 2.5.9 on Ubuntu 17.04

To install Xoops CMS 2.5.9 on Ubuntu 17.04

Xoops is a popular CMS and very easy to use, which is written in PHP. It uses a modular architecture and it is an ideal tool for developing small to large dynamic community websites, weblogs etc. It is so simple to install Xoops CMS on Ubuntu 17.04 In this tutorial, we will see how to install Xoops cms on ubuntu 17.04


Xoops CMS  requires a webserver to functionally based on LAMP setup on your system and also with following required PHP modules.

apt-get install php-mysql php-curl php-json php-cgi php libapache2-mod-php php-mcrypt php-xmlrpc php-gd php-mbstring php  php-common  php-xmlrpc php-soap  php-xml php-intl  php-cli  php-ldap php-zip php-readline php-imap php-tidy php-recode php-sqlite3 php-xdebug php-gettext php-dev php-pear php-memcache php-memcached php-bz2

Installing Xoops

First, make sure you update the system repository by making use of the following command. 

root@linuxhelp1:~# apt-get update
Hit:1 zesty InRelease
Hit:2 zesty-updates InRelease
Hit:3 zesty-backports InRelease
Hit:4 zesty-security InRelease
Reading package lists... Done

And then create the database for the Xoops as the root user and make the following configuration.

root@linuxhelp1:~# mysql -u root -p
Enter password: 
Welcome to the MariaDB monitor.  Commands end with ; or g.
Your MariaDB connection id is 10
Server version: 10.1.25-MariaDB- Ubuntu 17.04

Copyright (c) 2000, 2017, Oracle, MariaDB Corporation Ab and others.

Type 'help;' or 'h' for help. Type 'c' to clear the current input statement.

MariaDB [(none)]> create database xoops;
Query OK, 1 row affected (0.00 sec)

MariaDB [(none)]> grant all privileges on xoops.* to 'xoopsuser'@'localhost' identified by '123';
Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]> flush privileges;
Query OK, 0 rows affected (0.00 sec)

MariaDB [(none)]> exit;

And once it is done, you shall switch to the directory.


And also you should unzip the package.  

root@linuxhelp1:/home/user/Downloads# unzip -d /tmp/
   creating: /tmp/xoops-2.5.9/
  inflating: /tmp/xoops-2.5.9/.gitattributes  
  inflating: /tmp/xoops-2.5.9/.gitignore  
  inflating: /tmp/xoops-2.5.9/.scrutinizer.yml  
  inflating: /tmp/xoops-2.5.9/checksum.md5  
  inflating: /tmp/xoops-2.5.9/checksum.php  
  inflating: /tmp/xoops-2.5.9/  
   creating: /tmp/xoops-2.5.9/docs/
   creating: /tmp/xoops-2.5.9/upgrade/upd-2.5.4-to-2.5.5/
  inflating: /tmp/xoops-2.5.9/upgrade/upd-2.5.4-to-2.5.5/index.php  
   creating: /tmp/xoops-2.5.9/upgrade/upd-2.5.5-to-2.5.6/
  inflating: /tmp/xoops-2.5.9/upgrade/upd-2.5.5-to-2.5.6/index.php  
   creating: /tmp/xoops-2.5.9/upgrade/upd-2.5.7-to-2.5.8/
  inflating: /tmp/xoops-2.5.9/upgrade/upd-2.5.7-to-2.5.8/index.php  
   creating: /tmp/xoops-2.5.9/upgrade/upd-2.5.8-to-2.5.9/
  inflating: /tmp/xoops-2.5.9/upgrade/upd-2.5.8-to-2.5.9/index.php  
  inflating: /tmp/xoops-2.5.9/upgrade/upgrade_tpl.php

Switch to the extracted directory.

root@linuxhelp1:/home/user/Downloads# cd /tmp/

Move the file to the apache HTML root directory.

root@linuxhelp1:/tmp# mv xoops-2.5.9 /var/www/xoops

Switch to the HTML directory now.

root@linuxhelp1:/tmp# cd /var/www/

We need to change ownership and permission of the file.

root@linuxhelp1:/var/www# chown -R www-data.www-data xoops
root@linuxhelp1:/var/www# chmod -R 775 xoops

Once it is done, proceed to create a virtual host configuration file.

root@linuxhelp1:/var/www# vim /etc/apache2/sites-available/xoops.conf
<VirtualHost *:80>
DocumentRoot /var/www/xoops/htdocs/

<Directory /var/www/xoops/htdocs/>
AllowOverride All
allow from all


After saving the virtual host file we need to enable site access, which you can do by making use of the following command.

root@linuxhelp1:/var/www# a2ensite xoops.conf
Enabling site xoops.
To activate the new configuration, you need to run:
  systemctl reload apache2

And also we need to enable rewrite module.

root@linuxhelp1:/var/www# a2enmod rewrite
Enabling module rewrite.
To activate the new configuration, you need to run:
  systemctl restart apache2

Then, disable the default site access.

root@linuxhelp1:/var/www# a2dissite 000-default.conf
Site 000-default disabled.
To activate the new configuration, you need to run:
  systemctl reload apache2

Finally, restart the apache2 service to make the changes effect.

root@linuxhelp1:/var/www# systemctl restart apache2

Now you can continue the post-installation of Xoops from the browser. open a browser and type http://local IP (or) domain name. 

Start the installation by selecting the language for the installation. 

Next, the installation wizard will appear along with the welcome page, click continue to proceed further.

Next, it checks for the server configuration, once all the requirements were met you need to proceed further by clicking continue. 

Next, configure the path settings and click continue.

Configure the database connection and click continue.

Make the database configuration and click continue.

Save the system configuration and click on continue.

Create database tables and once it is done click continue. 

Enter the initial settings and proceed further by clicking continue.

Save the settings of the database, once done click continue. 

Next, you have to make the Site configuration. once configured continue further. 

Select the theme of your choice from the available default themes.

Next, Module installation. select and install the module based on your preference.


After all the configuration made, you will see the following screen  

In order to open Xoops site click on continue.

To browse as an admin and make changes click on Administration menu.

The following screen shows an Administration control panel where you can make changes as an admin to your site.

With this, the method to install Xoops CMS – 2.5.9 on Ubuntu 17.04 comes to an end.

Thank you! for using Linux Help.

You find this tutorial helpful? Share with your friends to keep it alive.
For more help topics browse our website
Be the first to comment, we value your suggestions. For further queries please comment below.

Tags: Ubuntu xoops
user image Author :  Matthew