ZenTao ManualBook Info
1 Introduction
1.1 About ZenTao
1.2 Introduction PPT
1.3 Technical Support
1.4 Follow Us
2 How to Install ZenTao
2.1 Choose the best 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 Set up Virtualbox for ZenTao
2.8 Softaculous service
3 Upgrade ZenTao
3.1 Upgrade ZenTao
3.2 Upgrade by source code (for all systems)
3.3 Upgrade for one-click installation for Windows (xampp)
3.4 Upgrade for one-click installation package for Linux
4 Users and Groups
4.1 Organization Structure
4.2 Add a User
4.3 Batch Manage Users
4.4 Groups and Privileges
5 Simple Application
5.1 Project and Task Management
5.2 Bug Management
5.3 Product Management
5.4 Individual Task 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 Stories
6.9 Story Breakdown
6.10 Report a Bug
6.11 Manage Contacts
6.12 Customization
7 Advanced Application
7.1 Workflow
7.1.1 ZenTao Workflow
7.2 Personal 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 Story Status
7.3.6 Notes for Writing a Story
7.3.7 Product Modules
7.3.8 Release Plan
7.3.9 Create a Release
7.3.10 Roadmap
7.3.11 Manage Documents
7.3.12 Product 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 Stories
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
7.5.3 Kanban and Tree Diagram
7.5.4 Create a Build
7.5.5 Test Task
7.5.6 Resolve a Bug
7.5.7 Manage Documents
7.5.8 Confirm Bugs
7.6 For QA Team
7.6.1 Bug Management
7.6.2 Report a Bug
7.6.3 Confim and Close a Bug
7.6.4 Activate a Bug
7.6.5 Locate a Bug
7.6.6 Test Cases
7.6.7 Create and Review Test Cases
7.6.8 Manage Test Tasks
7.6.9 Test Suites, Public Case Libs and Reports
7.6.10 Manage Test Tasks
7.6.11 Execute Cases and Report Bugs
7.6.12 Reports
8 Configuration
8.1 Maintain ZenTao
8.1.1 Initialize scripts
8.1.2 Back up ZenTao
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 Configure Static Access
8.2.5 Delete "zentao" from the address
8.2.6 Integrate ZenTao with SVN
8.2.7 Integrate ZenTao with Git
8.2.8 Integrate webhook
9 Custom Development
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 Packaging Standards of ZenTao 1.1
10 Other Relevant Issues
10.1 About third-party code
10.2 How to Help ZenTao
10.3 ZenTao Business Service
10.4 Acknowledgement

One-click Installation for Linux

2015-09-09 16:14:35
Last edited by Renee on 2018-02-25 11:02:32

One-click Installation Package for Linux has build-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 directory then copy it to /opt, as the owner and read/write privilesge of the files might be changed. 

 When Unzip, 

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

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 Sever (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 opensource OA collaborative product) ,  Zsite (our opensource CMS product) , Xuanxuan(our opensource IM for self host)  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. Access database(optional)

3.1 Web 

    3.1.1 ZenTao database manager is using 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 Access http://IP_of_ZenTao_Server: apache_port, click "MySQL" at the right bottom of the Page, in the popout window type your account added in addusers.sh . 

    3.1.3 Login database

  • System: MySQL is selected by default.
  • Server: For example,
  • 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 once reviewed.