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.
A CentOS 7 instance with at least 1 GB of RAM. 2 GB of RAM is recommended.
A sudo user.
EPEL yum repository.
Java.
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 OpenJDK
and JRE
using yum
as follows:
sudo yum install -y java-1.8.0-openjdk
Use the command below to verify the installed version of Java:
java -version
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](
https://github.com/MyCollab/mycollab/releases)._Â
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:
sudo /usr/bin/mysql_secure_installation
Below are the recommended responses to the questions prompted while running mysql_secure_installation
:
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 root
:
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 8080
:
sudo firewall-cmd --zone=public --permanent --add-port=8080/tcp
sudo firewall-cmd --reload
Visiting http://203.0.113.1:8080
in your browser will load the MyCollab setup wizard. You will need to click the Setup
button.
Site name: <Your Site Name>
Server address: 203.0.113.1
or example.com
Database name: mycollab
User name: mycollabuser
Password: yourpassword
Database server address: localhost
Input the necessary SMTP settings. You can leave them empty and change the settings later.
User name:
Password:
Server name:
Port:
STARTTLS:
or SSL/TLS:
Next, you will be asked to provide the login credentials for the new MyCollab admin user:
Admin email: <your-email-address>
Admin password: <your-admin-password>
Default date format, timezone, language, etc.
Finally, click the Setup
button to finish the wizard.
This concludes our tutorial. Thank you for reading.