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 Install Ioncube
3. Update
3.1 Update ZenTao
3.2 Update Via 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 Manage Users in batches
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 all systems)

2015-09-09 16:14:35
Last edited by Hongyan on 2021-12-28 08:52:43
Share links
Summary : Except for the one-click installation packages, you can also install the ZenTao runtime using source code package.

In addition to our one-click installation package, you can also deploy the ZenTao runtime environment when installing the source package.

1. Deploy PHP and MySQL runtime environment

There are many installation guides for PHP and MySQL, but you should pay attention to the following:
1.1 ZenTao requires modules like pdo, pdo_mysql, json, and filter, so make sure that PHP environment can load these modules.
1.2 Linux + Apache + PHP(5.3/5.4/5.5/5.6/7.0/7.1 + MySQL(5.5/5.6)/mariadb is recommended, followed by Nginx, while IIS+PHP is not recommended.

1.3 On Linux,  it is NOT recommended to compile and install PHP. You'd better install the PHP with a built-in Package Manager.

2. Download ZenTao source code

2.1 Download the latest source code (.zip file) from the ZenTao official website.

2.2 Unzip to get 'zentaoalm' directory. Copy to the directory corresponding to the webserver (see the configuration file of the webserver for details), such as 'www' or 'htdocs' of Apache.

2.3 Visit http:// IP:PORT/zentaoalm/www/index.php and it will automatically start the installation.

3. Installation Steps

 3.1 Welcome splash

 3.2 System checkup

 3.3 Database configuration

 3.4 Admin account

 3.5 Finish Installation

4. Notes

If you access http://ip:PORT/zentaopms/www/install.php in the Apache environment, the following error message pops out, you can delete the .htaccess file in the code and try again.

In the Linux:

[root@localhost zentaopms]# ls -la www/.htaccess 
-rw-rw-r-- 1 root root 788 1月   4 13:46 www/.htaccess
[root@localhost zentaopms]# rm -rf www/.ztaccess
In the Windows:

5. Reuse your Apache and MySQL (Optional)

Try Zdoo (our team collaborative product)) and  Zsite (our CMS product).

ProdMan 2023-07-21 19:19:05 Reply
Hi team,
Great job on the tool. I am trying to install this on a shared hosting. I have had following issues (Some of them I could also resolve)
1. First time page load goes into infinite loop with install.php calling install.php. Hence browser would not load the page with 'Too many redirects' error. To resolve this, I changed the install.php.tmp to install.php and the problem was resolved.
2. The installation stage loads without any theme [YET TO BE RESOLVED]
3. When you reach the DB details page, there is a weird thing happening:
(a) If I enter incorrect details for DB, this URL (/install.php?m=install&f=step3) loads with proper error.
(b) However, if I enter correct details, it almost instantly fails with Internal Error (500). Upon further investigation, I can see that the error in Network tab is "Failed to load response data: No resource with given identifier found".
One thing to note here is, since this is a shared hosting, the DB is not available locally but over the internet. What is bothering me is, the page load correctly even when I put in wrong creds - which means Zentao is able to communicate with my DB Server, just that it fails abruptly when it can connect successfully with the database. [YET TO BE RESOLVED]. Unfortunately, I could not find any obvious folder where logs may be stored to troubleshoot the 500 error.
Looking forward to your guidance.
philip 2023-07-25 09:12:02
You could delete the words "set global log_bin_trust_function_creators=1" and delete “SET global sql_mode = '' in the two files in installation package below: updatefunctions.sql zentao.sql
Raj 2022-02-02 18:20:25 Reply
How am i supposed to change the mysql database host from localhost to AWS rds?
philip 2022-02-03 11:11:26
Hi Ray,Could you give us your mail,we could help you to upload the database to AWS
xml 2019-01-06 10:53:35 Reply
i have install zentaopms by source codei in my docker (php7.30+apache+mariadb),i have install success and can login.but the html page layout is disarray。can you help me!
Renee 2019-01-07 07:06:05
Can you send me screenshots? I'm sending you emails to get more information.
lynx 2018-10-15 20:04:38 Reply

I installed Zentao on my own server.

Installation was successful and I could login.

But after login no theme is working. What can I do to make my themes work?

I also recognized I can't click anything that's triggered via "j a v a s c r i p t :;". This important for changing themes and languages.

What am I missing? How can I fix this?

Thanks in advance and good work so far!
Renee 2018-10-16 10:01:14
Can you send screenshots to renee@cnezsoft.com?
Write a Comment
Comment will be posted after it is reviewed.