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.
Step 1: Update the system
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
Step 2: Install Java
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)
Step 3: Obtaining the latest stable release of MyCollab Community Edition
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.
Step 4: Install and configure MariaDB
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
Step 5: Setup a MySQL database for MyCollab
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.
Step 6: Install MyCollab
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
- Site name:
<Your Site Name>
- Server address:
- Database name:
- User name:
- Database server address:
EMAIL SETUP (Optional)
Input the necessary SMTP settings. You can leave them empty and change the settings later.
- User name:
- Server name:
- or SSL/TLS:
Next, you will be asked to provide the login credentials for the new MyCollab admin user:
- Admin email:
- 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.
Want to contribute?
You could earn up to $300 by adding new articles
Suggest an update
Request an article