1. Get Docker ready

Strongly recommend Docker 18 or higher. No specific requirement for host environment.

Check your docker version.

docker -v

2. Download ZenTao image

Online download and offline import are both available to deploy ZenTao image. Choose one according to your environment.

2.1 Download

ZenTao image is uploaded to dockerhub, and you could find it here,  https://hub.docker.com/r/easysoft/zentao/tags

sudo docker pull [Image name]:[Image tag]

Pull an image, e.g. zentao:12.2.stable

sudo docker pull easysoft/zentao:12.2.stable

ZenTao version and Image tag:

ZenTao Version	Tag
Open source	Start with number, like 12.2.stable
Professional	Start with pro, like pro8.8
Enterprise	Strat with biz, like biz3.7

2.2. Import

ZenTao versions, image names and image links:

ZenTao Version	Image name	Image link ( Archive fiel directory )
Open source 12.3.1	easysoft/zentao:12.3.1	/dl/zentao_12.3.1.tar
Open source12.2.stable	easysoft/zentao:12.2.stable	/dl/zentao_12.2.stable.tar
Professional 8.8	easysoft/zentao:pro8.8	/dl/zentao_pro8.8.tar
Enterprise 3.7	easysoft/zentao:biz3.7	/dl/zentao_biz3.7.tar

As you can see above, image link names are combined of zentao_version number.tar

So how to import images?

1. Choose the right image link for you and import it into your host.
2. Go to archive file directory and run docker load

sudo docker load -i [Archive file directory]

Load an image, e.g. zentao_12.3.1.tar

sudo docker load -i zentao_12.3.1.tar

3. Docker start

3.1. Create a docker network

sudo docker network create --subnet=[ip range] [network driver name]

• IP range: 172.172.172.0/24 ranges from 172.172.172.1 to 172.172.172.254.
• Network driver name: a name for network driver, name as you wish.

sudo docker network create --subnet=172.172.172.0/24 zentaonet

3.2. Docker container start

sudo docker run --name [container name] -p [host port]:80 --network=[driver name] --ip [container IP] --mac-address [mac address] -v [host zentao root]:/app/zentaopms -v [host mysql root]:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=[database password] -d easysoft/zentao:[image tag]

• container name: name a container you want to start as you wish.
• host port: your web host port
• driver name: the network driver
• container IP: pick a static ip for your container
• MAC address: pick a static MAC address for your container, ranges from 02:42:ac:11:00:00 to 02:42:ac:11:ff:ff
• host ZenTao root: required, for ZenTao files and attachments storage. Leave it blank if you are not upgrading your ZenTao.
• host MySQL root: required, for ZenTao data storage. Leave it blank if you are not upgrading your ZenTao.
• database password: default account in container is root, 123456, do not mention it if you don't need to change anything, but you can use MYSQL_ROOT_PASSWORD to modify the password as well.
• image tag: the version of ZenTao.

Create blank roots in host for /app/zentaopms and /app/mysqldata

sudo docker run --name zentao -p 80:80 --network=zentaonet --ip 172.172.172.172 --mac-address 02:42:ac:11:00:00 -v /app/zentaopms:/app/zentaopms -v /app/mysqldata:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=123456 -d easysoft/zentao:12.2.stable

If you want to run multiple ZenTao on a single host at the same time, you just need to configure with different [contaniner name], [host port], [container IP], [mac address], [host zentao root], [host mysql root]

sudo docker run --name zentao2 -p 8080:80 --network=zentaonet --ip 172.172.172.173 --mac-address 02:42:ac:11:00:01 -v /app/zentaopms2:/app/zentaopms -v /app/mysqldata2:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=123456 -d easysoft/zentao:12.2.stable

3.3. Check if the container is running 

docker ps

If not running, run without -d and debug your container, feel free to contact our technical support by troy@easycorp.ltd.

4. Install ZenTao

5. Upgrade ZenTao

5.1. Stop the container

docker stop zentao

5.2. Back up ZenTao

For data security, backup [host zentao root] and [host mysql root], like copy/app/zentaopms and /app/mysql data to other root in host.

5.3. Get the newest source code package from https://www.zentao.pm/download.html.

5.4. Unzip it and overwrite to [host zentao root], like overwrite to /app/zentaopms

5.5. Start zentao container

docker start zentao

5.6. Visit upgrade.php, and choose the right current version and upgrade it.

Please refer to the manual here,  https://www.zentao.pm/book/zentaomanual/free-open-source-project-management-software-upgradezentao-18.html

6. FAQ

How to configure MySQL in a container?

Execute container first

docker exec -it [container name] /bin/bash

For example, execute zentao container, edit my.cnf, save it and restart mysql

docker exec -it zentao /bin/bash

vi /etc/mysql/my.cnf

It's the same to configure Apache and PHP, related roots in the container as shown below,

• Apache: /etc/apache2/
• ZenTao: /app/zentaopms
• MySQL: /etc/mysql/
• PHP: /etc/php/7.0/apache2

Feel free to contact our technical support at troy@easycorp.ltd.