English | 中文
GitFox Front is the web frontend of GitFox, an all-in-one code hosting and DevOps platform. Built on the ZenTao PHP MVC framework, it provides a unified web UI for product management, project management, requirements, tasks, bugs, testing, and integrates with the GitFox backend for Git repository hosting, code review, CI/CD pipelines, artifact repositories, and code scanning.
This repository contains the frontend only. The GitFox backend is maintained in gitfox-server.
- Product and project management: products, projects, executions, requirements (stories), tasks, bugs, test cases, builds, and releases
- Code hosting: repositories, branches, tags, commits, merge requests, and webhooks
- Code review: merge request review flows, branch protection rules, and code owners
- CI/CD: pipeline management, runners, and scheduled jobs
- Artifact repository: container images, Helm charts, raw artifacts, recycle bin, and garbage collection
- Code scanning: rules, rule sets, scan plans, and scan tasks
- Spaces and permissions: multiple spaces, RBAC, and SSO/token authentication
- GitFox integration: user binding, issue association, and webhook integration with ZenTao
- Metrics and reports: built-in dashboards, metrics, and reports
- Internationalization: zh-CN, zh-TW, en, de, and fr
- PHP >= 5.6 (PHP 8.1+ recommended)
- ZenTaoPHP MVC framework
- ZUI and jQuery
- MySQL / MariaDB
- Caddy (default web server in the container image)
- RoadRunner (background cron scheduler and consumer)
- Docker / Docker Compose
Docker and Docker Compose are required. The example below starts three services:
zentao-db: MySQL databasezentao: GitFox frontend (hub.qc.oop.cc/test/gitfox-front:4.6)gitfox: GitFox backend
Create a docker-compose.yaml file:
services:
zentao-db:
image: hub.zentao.net/app/mysql:8.0.36-debian
container_name: zentao-db
ports:
- '3306:3306'
volumes:
- /data/zentao-mysql:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=pass4Zentao
- MYSQL_DATABASE=zentao
networks:
- zentao-net
healthcheck:
test: ["CMD-SHELL", "mysqladmin ping -h127.0.0.1 -uroot -p$$MYSQL_ROOT_PASSWORD"]
interval: 3s
timeout: 3s
retries: 10
start_period: 20s
zentao:
image: hub.qc.oop.cc/test/gitfox-front:4.5
container_name: zentao
ports:
- '80:80'
volumes:
- /data/zentao-file:/data
depends_on:
zentao-db:
condition: service_healthy
environment:
- ZT_MYSQL_HOST=zentao-db
- ZT_MYSQL_PORT=3306
- ZT_MYSQL_USER=root
- ZT_MYSQL_PASSWORD=pass4Zentao
- ZT_MYSQL_DB=zentao
- PHP_MAX_EXECUTION_TIME=120
- PHP_MEMORY_LIMIT=512M
- PHP_POST_MAX_SIZE=128M
- PHP_UPLOAD_MAX_FILESIZE=128M
- ZT_GITFOX_PORT=3000
- ZT_GITFOX_URL=3000
- IS_CONTAINER=true
networks:
- zentao-net
gitfox:
image: hub.zentao.net/test/gitfox-pro:4.5
container_name: gitfox
ports:
- '3000:3000'
- '3322:3322'
volumes:
- /data/zentao-file:/data
- /var/run/docker.sock:/var/run/docker.sock
depends_on:
zentao-db:
condition: service_healthy
networks:
- zentao-net
networks:
zentao-net:
driver: bridgeStart the stack:
docker compose up -dThen visit http://<server-address> to finish the initialization.
Before deployment, update the following according to your environment:
- MySQL password, data volume paths, and image addresses
The example images point to internal registries. Replace them with accessible image addresses for public deployment, and do not use the example password in production.
Frontend environment variables:
| Variable | Description |
|---|---|
ZT_MYSQL_HOST |
MySQL host |
ZT_MYSQL_PORT |
MySQL port |
ZT_MYSQL_USER |
MySQL user |
ZT_MYSQL_PASSWORD |
MySQL password |
ZT_MYSQL_DB |
MySQL database name |
ZT_GITFOX_PORT |
GitFox backend port |
ZT_GITFOX_URL |
GitFox backend URL or port |
PHP_MAX_EXECUTION_TIME |
PHP maximum execution time |
PHP_MEMORY_LIMIT |
PHP memory limit |
PHP_POST_MAX_SIZE |
PHP maximum POST size |
PHP_UPLOAD_MAX_FILESIZE |
PHP maximum upload file size |
IS_CONTAINER |
Set to true when running in a container |
Requirements: PHP >= 5.6 (PHP 8.1+ recommended), MySQL/MariaDB, and Caddy or Apache.
make common # assemble the runnable source tree into zentaopms/
make pms # build the distribution zip package
make ci # build the full CI packageBuild frontend assets:
php misc/minifyfront.phpRun the CLI tool:
php bin/ztclicd test
php spider.phpProject layout:
framework/: core framework classesmodule/: business moduleslib/: third-party libraries and utilitiesconfig/: global configurationdb/: database schemas and migrationswww/: web entry point and public assetsbin/: CLI toolsapi/: API definitionsroadrunner/: background workerstest/: testing framework and cases
| Component | Image |
|---|---|
| Frontend | hub.qc.oop.cc/test/gitfox-front:4.5 |
| Backend | hub.zentao.net/test/gitfox-pro:4.5 (example) |
| Database | hub.zentao.net/app/mysql:8.0.36-debian |
The backend and database images above are examples and point to internal registries. Replace them with the versions and addresses available in your environment.
This project is dual-licensed under ZPL 1.2 and AGPL 3.0. You may choose either license. See LICENSE.EN and GITFOX_LICENSE for details.
Copyright 2009-2026 Qucheng Geek Software (Qingdao) Co., Ltd. (www.gitfox.net)
Issues and Pull Requests are welcome.
- Website: https://www.gitfox.net
- Manual: https://gitfox.net/book/open-source/40.html
- Backend project: https://github.com/easysoft/gitfox-server