Skip to main content
Version: 1.0

ZenTao Getting Started

ZenTao is an Open Source software released under ZPL license. It integrates with Product Management, Project Management, QA Management, Document Management, Todos Management, Company Management etc. ZenTao is the best choice for software project management.

If you have installed Websoft9 Jenkins, the following steps is for your quick start


  1. Get the Internet IP of your Server on Cloud
  2. Check your Inbound of Security Group Rule of Cloud Console to ensure the TCP:80 is allowed
  3. Complete Five steps for Domain if you want to use Domain for ZenTao
  4. Get default username and password of ZenTao

ZenTao Initialization

Steps for you

  1. Using local Chrome or Firefox to visit the URL https://domain or https://Internet IP, start to install

  2. Choose a language, go to next step

  3. Accept LICENSE and check the environment for ZenTao

  4. Then configure the database connection information

  5. Save configure file

  6. Set your administrator account for ZenTao

Please don't select the [Import Demo data](Demo data only support chinese)

  1. Login by you set user and password

  2. ZenTao dashboard

  3. Register ZenTao official account, make your ZenTao connect to ZenTao's plugins Marketplace

Refer to ZenTao Manual to get more details

Having trouble?

Below is for you to solve problem, and you can contact Websoft9 Support or refer to Troubleshoot + FAQ to get more.

ZenTao QuickStart

ZenTao Setup

Configure SMTP

  1. Get SMTP related parameters in the mailbox management console

  2. Login ZenTao, open:【Admin】>【Message】>【Mail】, select SMTP as the mail

  3. Fill in the correct SMTP items

  4. After the setting is completed, a message notification is triggered to verify that SMTP is correct.

Set Languages

ZenTao supports multiple languages. Here are the main steps to install and set up multiple languages:

Install Plugin

ZenTao have provided Plugins Marketplace for you to extend functions of ZenTao

  1. Log in ZenTao, search the plugins you want to use

  2. Intall plugin

You can download plugin and unzip it, then upload to /zentao/module for installing also

ZenTao recover administrator password

If you don't remember your administrator password, please user phpMyAdmin to modify zt_user table of ZenTao's database, make the password of your adminitrator's value is e10adc3949ba59abbe56e057f20f883e, then your new password is 123456

Integrate Git

Refer to Integrate Git

Reference sheet

The below items and General parameter sheet is maybe useful for you manage ZenTao

Run docker ps, view all containers when ZenTao is running:

CONTAINER ID   IMAGE                    COMMAND                  CREATED         STATUS         PORTS                                   NAMES
bbe3b0d3441d easysoft/zentao:latest "bash -c 'cat /my_cm…" 8 minutes ago Up 8 minutes>80/tcp, :::9003->80/tcp zentao
0c04db7cc20a mysql:5.7 "docker-entrypoint.s…" 8 minutes ago Up 8 minutes 3306/tcp, 33060/tcp zentao-db


ZenTao installation directory: /data/apps/zentao
ZenTao source code path: /data/apps/zentao/data/zentao
ZenTao configuration file: /data/apps/zentao/data/zentao/config/config.php


no special port


# ZenTao Version
cat /data/apps/zentao/data/zentao/VERSION


sudo docker start | stop | restart | stats zentao
sudo docker start | stop | restart | stats zentao-db


ZenTao provides a set of command operations, please refer to the official documentation for details: Initialization Management Script


ZenTao API All request results are in JSON format, and whether the request is successful is judged according to the status of the returned result.