MyCollab is free, open-source team collaboration software. It is widely used by small and mid-size enterprises for project management and documentation.
In this tutorial we will be installing MyCollab on CentOS 7.
Log in as the sudo user and install the
epel repository and update the OS as follows:
sudo yum install epel-release -y sudo yum update -y sudo shutdown -r now
MyCollab requires Java Runtime Environment
JRE version 8 or higher. You can install
yum as follows:
sudo yum install -y java-1.8.0-openjdk
Use the command below to verify the installed version of Java:
The output should resemble:
openjdk version "1.8.0_111" OpenJDK Runtime Environment (build 1.8.0_111-b15) OpenJDK 64-Bit Server VM (build 25.111-b15, mixed mode)
cd wget https://github.com/MyCollab/mycollab/releases/download/Release_5.4.5/MyCollab-All-5.4.5.zip sudo yum install unzip -y unzip MyCollab-All-5.4.5.zip
Note: At the time this article was written, version 5.4.5 of MyCollab was the latest. You can also find the latest version of MyCollab on their Github Page.
MyCollab requires MySQL 5.5 or higher. However, MariaDB offers better performance and we can install it as follows:
sudo yum install mariadb mariadb-server -y
Start the MariaDB service:
sudo systemctl start mariadb.service sudo systemctl enable mariadb.service
Secure MariaDB's installation:
Below are the recommended responses to the questions prompted while running
Enter current password for root (enter for none): Enter Set root password? [Y/n]: Y New password: <your-own-password> Re-enter new password: <your-own-password> Remove anonymous users? [Y/n]: Y Disallow root login remotely? [Y/n]: Y Remove test database and access to it? [Y/n]: Y Reload privilege tables now? [Y/n]: Y
Log into the MySQL shell as
mysql -u root -p
We need to create a database schema using the
utf8mb4 character set for MyCollab:
CREATE SCHEMA mycollab DEFAULT CHARACTER SET utf8mb4;
Create a database username and password:
CREATE USER 'mycollabuser'@'localhost' IDENTIFIED BY 'yourpassword'; GRANT ALL PRIVILEGES ON mycollab.* TO 'mycollabuser'@'localhost' IDENTIFIED BY 'yourpassword' WITH GRANT OPTION; FLUSH PRIVILEGES; EXIT;
Note: Please use a more secure username and password for your database.
Use the existing MyCollab installer script as follows:
cd ~/MyCollab-5.4.5/bin ./startup.sh
You need to also setup your firewall to allow traffic to port
sudo firewall-cmd --zone=public --permanent --add-port=8080/tcp sudo firewall-cmd --reload
http://203.0.113.1:8080 in your browser will load the MyCollab setup wizard. You will need to click the
<Your Site Name>
Input the necessary SMTP settings. You can leave them empty and change the settings later.
Next, you will be asked to provide the login credentials for the new MyCollab admin user:
Finally, click the
Setup button to finish the wizard.
This concludes our tutorial. Thank you for reading.