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 all systems)
2.7  Source Code Installation for macOS
2.8  XAMPP-VM Installation for macOS
2.9  XAMPP Installation for macOS
2.10  Softaculous Service
2.11  Integrate Zdoo
2.12  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  Operation Mode
6.16  Points
6.17  Required Field
6.18  How to check privilege settings in ZenTao
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 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 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 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  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 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 Request
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 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 Application
8.2.12  Translation Add-on
8.2.13  Integrate Jenkins
8.2.14  Extension
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

One-click Installation for Linux

2018-08-01 13:29:00
azalea
12060
Last edited by John Ten on 2020-05-04 15:26:50

One-click Installation Package for Linux has built-in Apache, Php, MySQL. All you need to do is to unzip it.   We have 32-bit and 64-bit packages. Please choose one that fits your OS.


1. Installation(3 steps: unzip/start/login)

1.1 Unzip to /opt.

 Do NOT unzip to other directories then copy it to /opt, as the owner and read/write privilege of the files might be changed. 

 When Unzip, 

 please use :  tar -zxvf  ZenTaoPMS.X.X.stable.zbox_XX.tar.gz -C /op t.


1.2 Start/Stop Apache and MySQL 

    to Start : /opt/zbox/zbox start


1.3 Login ZenTao

    Use browser to access http://IP_of_ZenTao_Server: apache_port. ( default account is admin ,and its password 123456)

    Installation is ok.


1.4 Config Server  ( optional)


    to Change Apache Port:  /opt/zbox/zbox -ap portNumber

    to Change Mysql Port:  /opt/zbox/zbox -mp portNumber

    to Start with ports config:  /opt/zbox/zbox start -mp mp -ap ap

    to Stop    :  /opt/zbox/zbox stop

    to Restart:  /opt/zbox/zbox restart

    to Get Help:  /opt/zbox/zbox -h


2. Reuse your Apache and Mysql ( optional)

   For ZenTao 9.2.stable+, the security of Linux one-click installation package has been improved that PHP parse is forbidden.

If you want to install   Zdoo (our open source  collaborative system) ,   Zsite (our open source CMS) , Xuanxuan(our open source IM)  or  other third-party software, you have to change the file  /opt/zbox/etc/apache/httpd.conf


Modify  SetHandler text/plain to  SetHandler  application/x-httpd-php  then restart Apache.  Welcome to try    Zdoo ,  Zsite and Xuanxuan : )


3. Visit ZenTao database ( optional )

3.1 Web 

    3 .1.1 ZenTao database is managed by Adminer. For security reasons, account authentication is required when login. 

    Run /opt/zbox/auth/adduser.sh to add one  account you will. 


    3.1.2 Visit http://IP_of_ZenTao_Server: apache_port, and click "MySQL" at the right bottom of the Page. I n the popout window type your account that you added in addusers.sh . 


    3.1.3 Login the database

  • System: MySQL is selected by default.
  • Server: 127.0.0.1:MySQL_port. For example,  127.0.0.1:3306
  • Username: zentao. The default username is zentao. (if you changed, you could find it in /opt/zbox/app/zentao/config/db.php )
  • Password: 123456. The default password is 123456.(also in db.php)
  • Database: zentao. (also in  db.php )


3.2 Command line

    Login database:  /opt/zbox/bin/mysql -u root -P mysql_ port -p . For example, /opt/zbox/bin/mysql -u root -P 3306 -p.

    Import database: /opt/zbox/bin/mysql -u root -P msyql_ port -p DATABASE NAME < XXXX.sql . For example, /opt/zbox/bin/mysql -u root -P 3306 -p zentao < zentao.sql.



Write a Comment
Comment will be posted after it is reviewed.