How to install Collabtive 3.1 on Ubuntu 16.04

06 Mar 2018 2 214  0
How to install Collabtive 3.1 on Ubuntu 16.04
How to install Collabtive 3.1 on Ubuntu 16.04


In the following tutorial we will teach you how to install Collabtive 3.1 on Ubuntu 16.04.

Collabtive is an open source web-based project management software which was made in PHP. Its purpose is to help you keep track of your projects. Collabtive can be used to create task lists, milestones, time tracking, messaging, instant messaging, file management, role-based user permissions, reporting, exporting, calendaring, and multilingual interfaces.

This guide was made specifically for Ubuntu 16.04, however, it can work on any Linux distribution. The procedure of installing Collabtive 3.1 on Ubuntu 16.04, should not take more than 10 minutes.

Step 1: Installing Apache, PHP and MySQL

In this guide we will assume that Apache, PHP and MySQL are currently installed and configured on your Collabtive VPS. At the time this tutorial was made, the latest stable version was Collabtive 3.1 and it needed the following:

  • PHP 5.5 or PHP 7 with the mbstring and mysql (or sqlite) PHP extensions enabled.
  • Apache Web Server >= 2.0 compiled with mod_rewrite module and with the following directives allowed: DirectoryIndex, Deny, Allow, Options, Order, AddHandler, RewriteEngine, RewriteBase, RewriteCond and RewriteRule.
  • MySQL, MariaDB or SQLite installed on your server.

Step 2: Installing Collabtive

Retrieve the latest version of Collabtive and extract it by executing the commands below.

cd /opt
wget -O
unzip -d /var/www/html/collabtive/

Step 3: Set up file ownership

The web server user (www-data) has to be able to write to the ‘config.php’ file, ‘files’, and ‘templates_c’ folders. Running the commands below will allow this to happen.

sudo chown www-data:www-data -R /var/www/html/collabtive/

sudo chmod +w  /var/www/html/collabtive/config/standard/config.php

sudo chmod +w  /var/www/html/collabtive/files

sudo chmod +w  /var/www/html/collabtive/templates_c

Step 4: Creating a Virtual Host

Create a new virtual host directive in Apache. In our example we create a new apache configuration file called ‘collabtive.conf’ on your virtual server.

touch /etc/apache2/sites-available/collabtive.conf

Step 5: Creating a symbolic link

ln -s /etc/apache2/sites-available/collabtive.conf /etc/apache2/sites-enabled/collabtive.conf

‘a2ensite’ can also be used to enable the ‘collabtive.conf’ configuration in Apache.

sudo a2ensite collabtive.conf

Step 6: Configuring the collabtive.conf file

Modify the ‘collabtive.conf’ Apache configuration file.

vi /etc/apache2/sites-available/collabtive.conf

Append the lines shown below into the file.

<VirtualHost *:80>
 ServerAdmin [email protected]
 DocumentRoot /var/www/html/collabtive/
 <Directory /var/www/html/collabtive/>
 Options FollowSymLinks
 AllowOverride All
 ErrorLog /var/log/apache2/
 CustomLog /var/log/apache2/ common

Step 7: Restarting the Apache web server

Restart the Apache web server, this allows the changes to take effect.

service apache2 restart

Step 8: Creating a new database and assigning a user with permissions

Create a new MySQL database so Collabtive has something to use, then assign a user to it with full permissions.

mysql -u root -p

mysql> CREATE DATABASE collabtivedb;

mysql> GRANT ALL PRIVILEGES ON collabtivedb.* TO 'collabtiveuser'@'localhost' IDENTIFIED BY 'your-password' WITH GRANT OPTION;


mysql> quit

Step 9: Proceed with the installation via web installer

Open the web browser of you choice and enter the URL‘ page.

After this, you should be directed to the first page of the Collabtive web installer.

Select the installer language and verify that system requirement is met before choosing MySQL as the database driver. Then choose the MySQL database host, database name, database username, and database password. After this, just click to pursue the installation.

On the next page, create an administrator user and set its password.

For security reasons, we suggest that you remove the ‘install.php’ and ‘update.php’ files from the server.

rm /var/www/html/collabtive/install.php

rm /var/www/html/collabtive/update.php

You should now have fully installed Collabtive.

Login to the Administrator back end area at ‘http:///‘ to configure Collabtive so that it suits your needs. You can also stretch the functionality of your installation by using plugins and more.

Add a comment

Leave a Reply