1 Introduction
1.1 About ZenTao
1.2 Introduction PPT
1.3 Technical Support
1.4 Follow Us
2 Installation
2.1 Choose the right installation
2.2 ZenTao Cloud
2.3 One-click Installation for Windows
2.4 One-click Installation for Linux
2.5 Installation with Lampp
2.6 Source Code Installation for macOS
2.7 XAMPP-VM Installation for macOS
2.8 XAMPP Installation for macOS
2.9 Source Code Installation (for all systems)
2.10 Set up Virtualbox for ZenTao
2.11 Softaculous service
2.12 Integrate Zdoo
2.13 Install Ioncube
3 Update
3.1 Update ZenTao
3.2 Update by source code (for all systems)
3.3 Update for one-click installation for Windows (xampp)
3.4 Update for one-click installation package for Linux
4 Users and Groups
4.1 Company Structure
4.2 Add a User
4.3 Batch Manage Users
4.4 Groups and Privileges
5 Quick Start
5.1 Project and Task Management
5.2 Bug Tracking
5.3 Product Management
5.4 Todo Management
6 Basic Application
6.1 Basic Workflow
6.2 Agile and Scrum
6.3 ZenTao and Scrum
6.4 ZenTao Tutorial for Rookies
6.5 Create a Product
6.6 Create a Story
6.7 Create a Project
6.8 Confirm a Story
6.9 Task Breakdown
6.10 Report a Bug
6.11 Manage Contacts
6.12 Customization
6.13 Import Excel, CSV files
6.14 Document Management
6.15 Operation Mode
6.16 Points
6.17 Customize Required Field
6.18 Access Control
7 Advanced Application
7.1 Workflow
7.1.1 ZenTao Workflow
7.2 Individual management
7.2.1 My Todo
7.2.2 My Task, Story and Bug
7.2.3 My Profile
7.3 For Product Owner
7.3.1 Manage a Product
7.3.2 Manage a Product Line
7.3.3 Create and Review a Story
7.3.4 Change and Review a Story
7.3.5 Status and stage
7.3.6 Notes for Writing a Story
7.3.7 Product Module
7.3.8 Release Plan
7.3.9 Create a Release
7.3.10 Roadmap
7.3.11 Documents
7.3.12 Planning Meetings
7.3.13 Daily Scrum, Review and Retrospective Meetings
7.3.14 Story Reports
7.4 For Project Manager
7.4.1 Create a Project
7.4.2 Set up a Team
7.4.3 Confirm a Story
7.4.4 Story Breakdown
7.4.5 Daily Standup Meetings
7.4.6 Check Project Progress via Burndown Chart
7.4.7 Check Project Progress via Lists
7.4.8 Review and Retrospective Meetings
7.4.9 Basic reports on tasks
7.5 For Development Team
7.5.1 Project planning meeting and task breakdown
7.5.2 Claim tasks and update efforts
7.5.3 Kanban and Tree Diagram
7.5.4 Build
7.5.5 Test
7.5.6 Resolve a Bug
7.5.7 Documents
7.5.8 Confirm Bugs
7.6 For QA Team
7.6.1 Defect Management
7.6.2 Report a Bug
7.6.3 Verify and Close a Bug
7.6.4 Activate a Bug
7.6.5 Find a Bug
7.6.6 Test Case
7.6.7 Create and Review Test Cases
7.6.8 Test Suites, Public Case Libs and Reports
7.6.9 Manage Test Tasks
7.6.10 Execute Cases and Report Bugs
7.6.11 Reports
8 Configuration
8.1 Maintain ZenTao
8.1.1 Initialize scripts
8.1.2 Data Backup
8.1.3 Recover the Deleted
8.1.4 Update Burndown charts
8.1.5 ZenTao remote host
8.2 Deploy ZenTao
8.2.1 Guest Login
8.2.2 Email Notification
8.2.3 Set Super Admin
8.2.4 Static Access
8.2.5 Delete "zentao" from URL
8.2.6 Integrate SVN
8.2.7 Integrate Git
8.2.8 Integrate webhook
8.2.9 Integrate Xuan.im
8.2.10 Integrate Zdoo
8.2.11 Integrate Third-Party Application
9 Customization
9.1 ZenTao customization
9.2 ZenTao Directory
9.3 Locate and Change Files
9.4 ZenTao Database Structure
9.5 Common Modules
9.6 Add Features to Menu
9.7 Set Privileges to Modules
9.8 Examples: modify language prompt
9.9 Examples: set priority when creating bugs
9.10 Web Editor
9.11 ZenTao Packaging Standards 1.1
10 MIsc
10.1 About third-party code
10.2 Support ZenTao
10.3 ZenTao Commercial Service
10.4 Acknowledgement

Source Code Installation for macOS

2019-04-17 14:06:05
Last edited by Renee on 2019-04-18 10:48:28

You can use source code package to install ZenTao in macOS, and configure the Apache+Mysql+PHP runtime environment for it.

1. ZenTao RTE 

  • Apache + PHP(5.3/5.4/5.5/5.6/7.0/7.1) + MySQL(5.5/5.6)/mariadb (Nginx is the second best)
  • pdo, pdo_mysql, json, filter, openssl, mbstring, zlib, curl, gd, iconv
  • Apache+Mysql+PHP is recommended.

2. Configure RTE

2.1 Configure Apache

2.1.1 macOS has Apache built in. All you have to do is to start it and enter your admin and password.


2.1.2 Apache command lines

sudo apachectl start // start Apache
sudo apachectl stop // stop Apache 
sudo apachectl restart // restart Apache

2.1.3 Visit your localhost or in your browser. If you see "It works!", Apache is started. If you don't have to change webserver or port number, skip the following part and configure PHP.

2.1.4 Webserver and port number

  • default path: /Library/WebServer/Documents/
  • default port number: 80

2.1.5 If you don't change the default settings of Apache, go to configure PHP.

It is strongly recommended that you do NOT change the default settings, and reasons are as follows.

  • Changed configuration file can be risky.
  • Changed webserver path can cause file permission issues.

2.1.6 If you have to change webserver path or port number, refer to the instruction below.

    Back up the configuration file for Apache

sudo cp /etc/apache2/httpd.conf  /etc/apache2/httpd.conf.backup

    Open httpd.conf and search for "DocumentRoot". Change its path and restart Apache.

    Search "Listen 80" and change it to other port number. Then restart Apache.

2.2 Configure PHP

2.2.1 Check the version of PHP that is built in macOS and see whether it matches your ZenTao PHP version (5.3/5.4/5.5/5.6/7.0/7.1 ).

php -v

2.2.2 Open httpd.conf of Apache. Search "php" and you will have # LoadModule php7_module libexec/apache2/libphp7.so

Remove # of it.

sudo vim /etc/apache2/httpd.conf  # open httpd.conf 

2.2.3 Restart Apache.

2.3 Configure MySQL

ZenTao source code package is for MySQL 5.5\5.6. We strongly suggest that you install MySQL using Homebrew.

2.3.1 Install Homebrew package manager.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

After it is installed, check its version o see whether it is installed without problems.

2.3.2 Install MySQL 5.6.

brew install mysql@5.6

Run the command below to add variables .

echo 'export PATH="/usr/local/opt/mysql@5.6/bin:$PATH"' >> ~/.bash_profile

Loading variables.

source ~/.bash_profile

Start MySQL.

brew services start mysql@5.6

2.3.3 After you start MySQL, you are log in anonymously. Enter mysql_secure_installation to initialize root. 

Enter current password for root (enter for none) 
Set root password?  y
New password: 
Re-enter new password: 
Remove anonymous users?   y
Disallow root login remotely?  y
Remove test database and access to it?   n
Reload privilege tables now? y

If you want to use MySQL, use brew command lines to do it.

brew services start mysql@5.6 # start MySQL 
brew services restart mysql@5.6 # restart MySQL 
brew services stop mysql@5.6 # stop MySQL 

3. Install ZenTao

3.1 Download the package from ZenTao official website HERE.

3.2 Unzip the file and save it to Apache path (default path /Library/WebServer/Documents/).

sudo cp -r ~/Downloads/zentaopms/* /Library/WebServer/Documents/

3.3 Visit ZenTao in your browser at LOCALHOST IP:PORT NUMBER/www/index.php

3.4 Run the command line below if any issues regarding file privileges.

sudo chmod -R 777 /Library/WebServer/Documents

3.5 If any issues regarding session.save_path, follow the instructions below.

Change PHP configuration file /etc/php.ini.default and back it up, then rename it as php.ini. Open the file and search  session.save_path  = "/tmp". Change the value of  "/tmp". It is recommended that you change the path to /Users/LOGIN USERNAME as shown below.

sudo chmod -R 777 /Users/login username

Configure MySQL and check whether Check MySQL is on.

    Write a Comment
    Comment will be posted once reviewed.
    • Contact Us

    • About Us
    • Email : Philip@easysoft.ltd
    • WhatsApp : 0086 18563953295
    • Skype : philip517