Skip to content
Klutch.sh Docs

Deploying ZenTao

Introduction

ZenTao is an open-source project management solution designed specifically for Agile and Scrum teams. It provides comprehensive features for managing the entire software development lifecycle, including requirements, tasks, bugs, and releases, all in one integrated platform.

Key highlights of ZenTao:

  • Scrum Support: Full Scrum methodology with sprints, backlogs, and burndown charts
  • Kanban Boards: Visual task management with drag-and-drop
  • Bug Tracking: Comprehensive issue tracking and resolution workflow
  • Test Management: Test case creation, execution, and reporting
  • Release Management: Plan and track software releases
  • Document Management: Store and organize project documentation
  • Reports and Metrics: Built-in reports for project insights
  • Multi-Project: Manage multiple projects from one installation

This guide walks through deploying ZenTao on Klutch.sh using Docker.

Why Deploy ZenTao on Klutch.sh

Deploying ZenTao on Klutch.sh provides several advantages:

Complete ALM: Application Lifecycle Management in one self-hosted platform.

Team Collaboration: Access your project management from anywhere.

HTTPS by Default: Secure access with automatic SSL certificates.

Persistent Storage: Your project data persists with Klutch.sh volumes.

Prerequisites

Before deploying ZenTao on Klutch.sh, ensure you have:

Deploying ZenTao on Klutch.sh

    Create Your Repository

    Create a new GitHub repository with a Dockerfile:

    FROM easysoft/zentao:latest
    

    ENV MYSQL_ROOT_PASSWORD=${MYSQL_ROOT_PASSWORD}
    ENV MYSQL_DATABASE=zentao
    ENV APACHE_PORT=80
    

    VOLUME ["/www/zentaopms/tmp", "/www/zentaopms/www/data"]
    

    EXPOSE 80
    

    CMD ["/run.sh"]

    Push to GitHub

    Push your Dockerfile to your GitHub repository.

    Create a New Project on Klutch.sh

    Navigate to the Klutch.sh dashboard and create a new project.

    Create a New App

    Within your project, create a new app and connect your GitHub repository.

    Configure HTTP Traffic

    Set the traffic type to HTTP with port 80.

    Set Environment Variables

    Configure the following environment variables:

    VariableValue
    MYSQL_ROOT_PASSWORDYour MySQL root password
    MYSQL_DATABASEzentao

    Attach Persistent Volumes

    Add persistent volumes:

    Mount PathPurpose
    /www/zentaopms/tmpTemporary files and sessions
    /www/zentaopms/www/dataUploaded files and attachments

    Deploy Your Application

    Click Deploy to build and launch ZenTao.

    Complete Setup

    Access your ZenTao instance and follow the installation wizard. The default admin credentials are admin/123456 - change them immediately.

Additional Resources

Conclusion

ZenTao on Klutch.sh provides a comprehensive Agile project management solution for software teams. Manage your entire development lifecycle from requirements to release with built-in Scrum support and extensive reporting capabilities.