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:

  cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env up -d
  

• Stop services:

  cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env down
  

• Restart services:

  cd /home/ubuntu/plane-selfhost/plane-app && docker compose --env-file=plane.env restart
  

• View logs:

  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.