1 Introduction
1.1  About ZenTao
1.2  Introduction PDF
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  Lampp Installation in Linux
2.6  Source Code Installation (for all systems)
2.7  Source Code Installation for macOS
2.8  XAMPP-VM Installation for macOS
2.9  XAMPP Installation for macOS
2.10  Install ZenTao in Docker
2.11  Install httpd, Mariadb, PHP 7.2 in Cent OS 8
2.12  Softaculous Service
2.13  Integrate Zdoo
2.14  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 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  Decompose Stories into Tasks
6.10  Report a Bug
6.11  Manage Contacts
6.12  Customization
6.13  Import Excel, CSV Files
6.14  Document Management
6.15  Work Mode
6.16  Points
6.17  Required Field
6.18  Privileges
6.19  Annual Work Summary
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 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 Phase
7.3.6  Story Writing
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 Scrum Master
7.4.1  Create a Sprint
7.4.2  Set a Team
7.4.3  Confirm a Story
7.4.4  Task 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 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 Request
7.5.6  Resolve a Bug
7.5.7  Documents
7.5.8  Confirm Bugs
7.6 Test Team
7.6.1  Bug Tracking
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 Requests
7.6.10  Run 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  Remove "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 Apps
8.2.12  Password-Free Login
8.2.13  Translation Add-on
8.2.14  Integrate Jenkins
8.2.15  Extension
8.2.16  Fix Weak Password
9 Customization
9.1  Introduction
9.2  Directory
9.3  Find Codes
9.4  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  Extension Editor
9.11  Feature Limitation
9.12  ZenTao Packaging Standards 1.1
10 Misc
10.1  About Third-Party Code
10.2  Support ZenTao
10.3  ZenTao Service
10.4  Acknowledgement

Source Code Installation for macOS

2019-04-17 14:06:05
Last edited by Taotao on 2021-05-17 10:40:35

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 permissions.

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.

If you see the screenshot above, ZenTao is installed.

jarek 2019-07-14 16:22:00
is any package to easy install Zentao by uploading
to web-server over Ftp?
(PHP 7 and MySql only)

Renee 2019-07-15 09:22:55
Yes, you can find the source code for PHP7+MySQL. Which version are you looking for? We have

- ZenTao open source version(free)
- ZenTao Professional (advanced features including SVN/GIT integration, Reports, Document management, etc.)
- ZenTao Enterprise ( DevOps management, Attendance Management, Feedback Management, etc.)
Write a Comment
Comment will be posted after it is reviewed.