禅道项目管理软件是一款国产开源项目管理软件。它集项目集管理、产品管理、项目管理、质量管理、DevOps、知识库、BI效能、工作流、学堂、反馈管理、组织管理和事务管理于一体，是一款专业的研发项目管理软件，完整覆盖了研发项目管理的核心流程。
禅道目前提供多种解决方案：规模化敏捷解决方案、DevOps一体化解决方案、自动化测试解决方案，研发效能解决方案、禅道基于IM+AI的研发协同解决方案、企业创新能力解决方案、企业决策分析解决方案，让每一个项目都可实现高效管理。
禅道智能应用平台是一个开源轻量级应用交付平台。通过应用市场，可以一键安装企业级软件，不仅具备高可用特性，还支持自动与手动备份，当有新版本发布时，可以查看软件的更新日志，决定是否升级，快捷方便。
如果您刚接触禅道智能应用平台，建议使用我们提供的All-in-One安装模式,它能够帮助您零配置快速部署。
若要以All-in-One模式进行安装，您仅需参考以下对机器硬件和操作系统的要求准备一台主机。
1.1硬件推荐配置
操作系统
最低配置
DebianBookworm(推荐)Bullseye
2核CPU,4GB内存,40GB磁盘空间
Ubuntu22.04,20.04
1.2节点要求
1.3容器运行时
您的集群必须有一个可用的容器运行时。如果您使用q搭建集群,会探测本地是否已安装docker,如果已安装docker则使用docker,否则将使用默认内置的containerd
1.4网络和DNS要求
qinit-pquickon3.1开源版
一般来说,对于All-in-One安装,不需要修改任何配置。如果你想自定义集群网络、访问域名等高级的功能，可以通过参数来配置：
#示例,更多参数参考使用qinit--helpqinit-pquickon--domain<自定义域名>4.验证安装结果
输出信息会显示Web控制台的IP地址和端口号,默认的端口是32379您可能需要配置端口转发规则并在安全组中开放端口，以便外部用户访问控制台。
1.下载windows一键安装包
2.运行安装包
双击下载的文件解压到某一分区的目录下，进入ZenTao文件夹，点击ZenTao.exe文件启动面板。
注意：若安装包所在路径包含中文等特殊符号，启动禅道时会出现错误提示。需要修改路径后重新启动禅道。
3.设置
点击设置按钮，可以卸载服务、查看服务、设置语言、查看帮助、检查更新、切换主题操作。
卸载服务时，会卸载运行控制面板里所有的服务。
Apache可以进行查看日志、修改端口、修改密码、安装服务、卸载服务、停止服务、启动服务、安装服务操作。
以上操作中除了查看日志，修改端口、重新安装都会重新启动Apache服务。
修改端口时，会自动检查端口是否被占用，如果被占用会有相应的提示并不可修改。
5.Apache用户访问验证
系统默认不启用Apache用户访问验证，如果不需要，可跳过这一步。
注：Apache用户访问验证的初始账号：zentao,密码：123456。
初次默认的管理员账号是：用户名：admin密码：123456。
7.修改禅道密码
如果需要维护密码安全设置可以到后台—安全页面中进行修改。
注意：从禅道18.12系列版本开始，禅道的Windows一键安装包不再集成git和svn。
如果需要使用集成git和svn功能，可下载集成包覆盖到禅道一键安装包的代码目录。
下载解压直接覆盖后，可以在ZenTao/bin下查看到git和sliksvn的文件夹。
1.环境准备
环境与配置
测试环境
推荐配置
备注
Docker
20版本
20版本以上
Linux或Windows
Linux
镜像支持x86_64和arm64架构
CPU
1核心
2核心
内存
1G
4G
硬盘
10G
50G以上
查看Docker版本：
docker-vDockerversion27.0.3,build7d4bcd8
查看CPU架构：
uname-aLinuxnat76.6.13+bpo-amd64#1SMPPREEMPT_DYNAMICDebian6.6.13-1~bpo12+1(2024-02-15)x86_64GNU/Linux2.下载禅道镜像
目前支持在线下载和离线导入两种部署禅道镜像的方式，可根据自己环境进行选择。
2.1在线下载
可根据所需版本拉取对应版本的镜像，默认latest为禅道开源最新版本。
sudodockerpull[镜像名]:[镜像标签]
例如拉取禅道开源版20.3版本命令如下：
sudodockerpullhub.zentao.net/app/zentao:20.3
注意：
禅道版本和镜像tag对应关系如下：
禅道版本
镜像标签
开源版
以数字开头，如20.3
企业版
以biz开头，如biz10.2
旗舰版
以max开头，如max5.2
IPD版
以ipd开头，如ipd2.2
2.2离线导入
导入镜像步骤如下：
#命令实例sudogunzip-c[镜像归档文件名]|dockerload#如：sudogunzip-czentao_20.3.tar.gz|dockerloadda07e39e2957:Loadinglayer[======================>]85.5kB/85.5kBfeab8630a9c5:Loadinglayer[======================>]11.73MB/11.73MBd7508f92bff7:Loadinglayer[======================>]86.37MB/86.37MB5ca65d83e7b7:Loadinglayer[======================>]80.38MB/80.38MBed0cfb41d961:Loadinglayer[======================>]2.673MB/2.673MBc00e8d737e49:Loadinglayer[======================>]10.3MB/10.3MBa186fa70a0c6:Loadinglayer[======================>]7.121MB/7.121MB95e38b2ff244:Loadinglayer[======================>]7.473MB/7.473MBf4afc75280d8:Loadinglayer[======================>]191.7MB/191.7MB60721d394939:Loadinglayer[======================>]89.6kB/89.6kB6db6be18e64c:Loadinglayer[======================>]15.87kB/15.87kBcf41eda4f35b:Loadinglayer[======================>]191.7MB/191.7MBLoadedimage:hub.zentao.net/app/zentao:20.33.启动禅道
3.1创建docker网络驱动
sudodockernetworkcreate--subnet=[ip范围][网络驱动名]例如：
sudodockernetworkcreate--subnet=172.172.172.0/24zentaonet3.2启动禅道容器
命令格式如下：
sudodockerrun\--name[容器名]\-p[主机端口]:80\--network=[网络驱动名]\--ip[容器IP]\--mac-address[mac地址]\-v[主机禅道目录]:/data\-eMYSQL_INTERNAL=true\-dhub.zentao.net/app/zentao:[镜像标签]参数说明：
例如：在主机上创建空目录/data/zentao，执行如下命令
sudodockerrun\--namezentao\-p80:80\--network=zentaonet\--ip172.172.172.172\--mac-address02:42:ac:11:00:00\-v/data/zentao:/data\-eMYSQL_INTERNAL=true\-dhub.zentao.net/app/zentao:20.3注意：
sudodockerrun\--namezentao2\-p8080:80\-p3306:3306\--network=zentaonet\--ip172.172.172.173\--mac-address02:42:ac:11:00:01\-eMYSQL_INTERNAL=true\-v/data/zentao2:/data\-dhub.zentao.net/app/zentao:20.33.3查看容器是否启动成功
执行如下命令查看容器是否启动成功，如果没有则启动失败，去掉-d选项进行前台运行调试容器，如有任何问题请咨询禅道商务同事。
#查看禅道容器dockerps|grepzentao#查看禅道容器日志dockerlogs-fzentao4.安装禅道
最后根据提示进行操作，即可安装成功。
欢迎下载使用禅道，如果在使用过程过中遇到任何问题，欢迎联系我们，我们会给予您及时的帮助。