vickytechkey
2d30c2ddfc
All checks were successful
Deploy Plane Project Tracker / Deploy to cisystem (push) Successful in 13s
54 lines
2 KiB
Markdown
54 lines
2 KiB
Markdown
# Plane Community Edition Self-Host (Jira Replacement)
|
|
|
|
This repository contains the deployment configuration and CI/CD workflow for self-hosting **Plane Community Edition** on `https://jira.tradhox.com`.
|
|
|
|
## Architecture & Infrastructure
|
|
|
|
- **Stack**: Official Plane Community Edition Docker images (`v1.4.3`).
|
|
- **Database**: External PostgreSQL (`15.x`) on host `localhost:5432` (`host.docker.internal:5432` from Docker).
|
|
- **Reverse Proxy**: Host Nginx with Let's Encrypt SSL proxying `https://jira.tradhox.com` to internal container port `127.0.0.1:8090`.
|
|
- **File Storage**: AWS S3 bucket `trypostmedia` (region `ap-south-2`, prefix `jiradocuments/`).
|
|
- **Messaging & Cache**: Containerized Valkey (Redis) and RabbitMQ.
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
.
|
|
├── .forgejo/
|
|
│ └── workflows/
|
|
│ └── deploy.yml # CI/CD deployment workflow for Forgejo
|
|
├── patches/
|
|
│ └── storage.py # AWS S3 prefix support patch
|
|
├── docker-compose.yaml # Plane Docker Compose definition
|
|
├── plane.env.example # Environment template
|
|
├── setup.sh # Official Plane CLI setup script
|
|
└── README.md
|
|
```
|
|
|
|
## Server Deployment
|
|
|
|
The deployment runs on the server at:
|
|
`/home/ubuntu/plane-selfhost/plane-app`
|
|
|
|
### Commands on the server:
|
|
|
|
- **Start services**:
|
|
```bash
|
|
cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env up -d
|
|
```
|
|
- **Stop services**:
|
|
```bash
|
|
cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env down
|
|
```
|
|
- **Restart services**:
|
|
```bash
|
|
cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env restart
|
|
```
|
|
- **View logs**:
|
|
```bash
|
|
cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env logs -f [service]
|
|
```
|
|
|
|
## CI/CD Pipeline
|
|
|
|
Pushes to `preview`, `main`, or `master` branches automatically trigger the Forgejo workflow `.forgejo/workflows/deploy.yml` which deploys updates to `cisystem`.
|