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.
wget https://sourceforge.net/projects/collabtive/files/latest/download -O collabtive.zip
unzip collabtive.zip -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.
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.
Append the lines shown below into the file.
<VirtualHost *:80> ServerAdmin [email protected] DocumentRoot /var/www/html/collabtive/ ServerName your-domain.com ServerAlias www.your-domain.com <Directory /var/www/html/collabtive/> Options FollowSymLinks AllowOverride All </Directory> ErrorLog /var/log/apache2/your-domain.com-error_log CustomLog /var/log/apache2/your-domain.com-access_log common </VirtualHost>
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> FLUSH PRIVILEGES; mysql> quit
Step 9: Proceed with the installation via web installer
Open the web browser of you choice and enter the URL
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:///your-domain.com‘ to configure Collabtive so that it suits your needs. You can also stretch the functionality of your installation by using plugins and more.