# Plane

> Open-source project management tool like Jira.

- Category: Productivity & Collaboration
- Difficulty: intermediate
- Components: plane, postgres, redis, minio
- Tags: plane, project, management, jira
- Source: https://docker.recipes/productivity/plane

## Overview

Plane is an open-source project management platform that serves as a compelling alternative to proprietary tools like Jira and Linear. Developed with modern web technologies, Plane offers comprehensive project tracking capabilities including issue management, sprint planning, and team collaboration features. The platform emphasizes user experience with a clean interface while maintaining powerful functionality for agile development workflows. This deployment stack combines Plane's frontend and backend services with PostgreSQL for robust data persistence and Redis for high-performance caching and session management. PostgreSQL provides the ACID compliance and complex query capabilities essential for project management data integrity, while Redis delivers sub-millisecond response times for real-time collaboration features and user sessions. The architecture separates concerns effectively, allowing the frontend to communicate with the API layer while maintaining data consistency across all project management operations. Organizations seeking to maintain control over their project management data while avoiding vendor lock-in will find this stack particularly valuable. The combination offers enterprise-grade reliability through PostgreSQL's proven stability, enhanced performance via Redis caching, and complete customization freedom through Plane's open-source nature. Development teams, startups prioritizing data sovereignty, and enterprises requiring on-premises project management solutions benefit from this self-hosted approach that rivals commercial alternatives.

## Features

- Complete issue tracking system with customizable workflows and status transitions
- Sprint planning and agile project management with burndown charts and velocity tracking
- Real-time collaboration powered by Redis pub/sub messaging for instant updates
- Advanced project analytics and reporting backed by PostgreSQL's window functions
- Team workspace management with role-based permissions and project access control
- API-first architecture enabling custom integrations and workflow automation
- Multi-project support with cross-project dependencies and portfolio views
- PostgreSQL full-text search for comprehensive issue and project content discovery

## Use cases

- Software development teams migrating from Jira to reduce licensing costs
- Startups requiring full control over project management data and user information
- Remote development teams needing real-time collaboration on project planning
- Organizations with compliance requirements mandating on-premises data storage
- Development agencies managing multiple client projects with separate workspaces
- Open-source projects requiring transparent and customizable project management
- Companies integrating project management with existing internal tools via API

## Prerequisites

- Minimum 2GB RAM recommended for optimal performance across all services
- Docker and Docker Compose installed with support for multi-service orchestration
- Available ports 3000, 8000 for frontend and API access respectively
- Basic understanding of environment variable configuration for secrets management
- Familiarity with PostgreSQL backup procedures for production deployments
- Knowledge of agile project management concepts for effective Plane utilization

## docker-compose.yml

```yaml
services:
  plane-web:
    image: makeplane/plane-frontend:latest
    container_name: plane-web
    restart: unless-stopped
    environment:
      NEXT_PUBLIC_API_BASE_URL: http://localhost:8000
    ports:
      - "3000:3000"
    depends_on:
      - plane-api
    networks:
      - plane

  plane-api:
    image: makeplane/plane-backend:latest
    container_name: plane-api
    restart: unless-stopped
    environment:
      DATABASE_URL: postgres://plane:${DB_PASSWORD}@postgres:5432/plane
      REDIS_URL: redis://redis:6379
      SECRET_KEY: ${SECRET_KEY}
    ports:
      - "8000:8000"
    depends_on:
      - postgres
      - redis
    networks:
      - plane

  postgres:
    image: postgres:15-alpine
    container_name: plane-postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: plane
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_DB: plane
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - plane

  redis:
    image: redis:alpine
    container_name: plane-redis
    restart: unless-stopped
    networks:
      - plane

volumes:
  postgres_data:

networks:
  plane:
    driver: bridge
```

## .env

```bash
DB_PASSWORD=changeme
SECRET_KEY=generate-a-secret-key
```

## Usage notes

- Frontend at http://localhost:3000
- API at http://localhost:8000
- Jira/Linear alternative

## Troubleshooting

- Frontend shows connection errors: Verify NEXT_PUBLIC_API_BASE_URL matches your actual API endpoint and plane-api container is running
- Database connection refused: Check DATABASE_URL format and ensure postgres container started before plane-api, verify DB_PASSWORD matches between services
- Redis connection timeout: Confirm redis container is accessible on port 6379 and REDIS_URL environment variable is correctly formatted
- Plane API returns 500 errors: Check SECRET_KEY environment variable is set and container logs for Django/PostgreSQL connection issues
- Slow project loading times: Monitor PostgreSQL performance and consider increasing shared_buffers, check Redis memory usage for caching efficiency
- User sessions not persisting: Verify Redis container has sufficient memory allocation and is not experiencing eviction policies

