- Java Runtime Environment 8+: MyCollab could run when any JVM-compatible platform such as Oracle JRE or OpenJDK.
- MySQL database, version 5.5+: the higher version is better
- 1 GB RAM minimum, 2 GB RAM recommended
MyCollab has two editions:
- MyCollab Ultimate Edition: the paid edition which provides full features of MyCollab, run faster, and a dedicated support team. This edition is suitable for a professional team who want to keep update all aspects of project activities. MyCollab Ultimate Edition offers 30 days free trial, and you can download it at https://www.mycollab.com/ee-registration/
- MyCollab Community Edition: this free and open source edition which is the lite edition of MyCollab Ultimate Edition. It provides the essential features of tasks, issues, knowledge management, and other project activities management. Its download address is https://www.mycollab.com/ce-registration/.
Both editions share the same installation method, and requires you register an account to get the download link.
After downloading MyCollab installer file, unzip MyCollab-All-x.x.x.zip to the machine folder. Please note the user must have the write permission to that folder while MyCollab requests the write permission to write the config file at the first time you start using MyCollab.
Install MySQL server
You need to install MySQL server since MyCollab stores all data in MySQL server. If you do not install MySQL server yet, this link http://dev.mysql.com/doc/refman/5.7/en/installing.html will help you install the latest MySQL server version.
Create MyCollab database
MyCollab needs a database to run; you must create a MySQL schema by the following command:
CREATE SCHEMA mycollab DEFAULT CHARACTER SET utf8mb4 ;
Below is our example in screenshot to create the MyCollab schema
Install Java and verify Java path
If you already know how to set up Java and your server already installed Java Runtime Environment 8+, then you can ignore this step. Otherwise, below guidelines are helpful for you
If Java is not present:
- Access the site https://java.com/en/download/
- Download Java for your platform
- Install Java and follow the site’s instruction
Open the console window, and type java -version. If the response message says it can not recognize Java program, then you must add java to the system path variables. Check the guideline in this link https://docs.oracle.com/javase/tutorial/essential/environment/paths.html. You must make sure Java is installed correctly on your server; otherwise, you can not run MyCollab successfully from next step.
If you are running MyCollab on Linux, you can install the Open-JDK as well
Go to %MYCOLLAB_HOME%/bin (where %MYCOLLAB_HOME% is the folder which you installed MyCollab) and start MyCollab.
MyCollab will show the installation page ask you several inputs to help you install MyCollab easily
Site name: MyCollab or any value you like. The site name displays in email or browser window title
Server address: localhost is the value uses for only testing while you run MyCollab. Otherwise, you should select the server name such as the machine IP (static IP) in your LAN or domain name if you use MyCollab in WAN
Enter database server address: localhost
Note: We assume you install MySQL dev database in the same of MyCollab. Otherwise, please type the right address of MySQL that MyCollab can access.
Database name (You must create the database before): mycollab
User name: <Your value>
Database Server Address: <Your value>
Then we will ask you give us an SMTP configuration in order MyCollab can send system notifications to you and your team.
Note: you can skip SMTP setting if you do not need to receive notification from your MyCollab installation, but we encourage you must set up SMTP to utilize the power of MyCollab in sending email notifications to notify you and your team whether an assignment is created and assigned or so on.
SMTP server name: <Your SMTP server> (Example: smtp.gmail.com)
Port: <Your SMTP server port> (Example: 587)
User name: <Your mail user name> (Example: firstname.lastname@example.org)
Password: <Your mail password> (Example: Your gmail password)
Enable StartTls (y/n): <Enable StartTls or not> (Example: yes for Gmail service provider)
Enable TLS/SSL(y/n): <Enable Tls/SSL or not> (Example: yes for Yahoo or several other service providers)
Note: By default, MyCollab will run on the port 8080. You can change this port value to any value you want by edit and change variable MYCOLLAB_PORT in script mycollab.bat (on Windows) or mycollab.sh (on Linux, Unix or MacOS) and restart the server.
After filling all required fields and press button ‘Upgrade & Go’, MyCollab will validate all input fields and do the installation steps such as writing config files, write data into the database, etc. This process may take several minutes. After MyCollab finishes the installation process, it will redirect you to the MyCollab page
- If you are running MyCollab 5.3 and higher, at the first time of running MyCollab, it will redirect you to the page to setup the first user, account settings, and sample project data
After adding the new user, MyCollab will redirect you to the project dashboard.
Having problems? See Common errors in installation
Translating MyCollab to your language
Help us to translate MyCollab to your language. No programming knowledge is required!