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

Preparation​

  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   0.0.0.0:9003->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

Path​

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

Port​

no special port

Version​

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

Service​

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

Cli​

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

API​

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.