# Taiga

> Agile project management platform.

- Category: Productivity & Collaboration
- Difficulty: advanced
- Components: taiga-back, taiga-front, postgres, rabbitmq
- Tags: taiga, agile, scrum, kanban
- Source: https://docker.recipes/productivity/taiga

## Overview

Taiga is an open-source agile project management platform developed by Kaleidos that provides comprehensive tools for Scrum and Kanban methodologies. Built with Django REST framework for the backend and Angular for the frontend, Taiga offers features like user story management, sprint planning, burndown charts, swimlane boards, and team collaboration tools. It was created to bridge the gap between complex enterprise project management solutions and simple task tracking tools, providing agile teams with a powerful yet intuitive platform for managing their projects.

This deployment consists of four specialized services: taiga-back handles the Django-based REST API and business logic, taiga-front serves the Angular-based user interface, a PostgreSQL database for persistent data storage, and RabbitMQ for message queuing and real-time notifications. The configuration separates frontend and backend concerns, enabling independent scaling and maintenance while providing a complete agile project management solution accessible through a web browser.

This stack is ideal for development teams, startups, and organizations looking to implement agile methodologies with a self-hosted solution. The separation of frontend and backend services makes it suitable for teams that need to customize either component independently, while the inclusion of PostgreSQL ensures robust data integrity for project artifacts, user stories, and historical sprint data.

## Features

- Complete Scrum implementation with epics, user stories, tasks, sprints, and burndown charts
- Kanban boards with swimlanes, WIP limits, and cumulative flow diagrams
- Real-time collaboration through RabbitMQ-powered WebSocket notifications
- Flexible role-based permissions with customizable project roles and member access
- Import capabilities from Trello, Jira, GitHub, and Asana for project migration
- Custom fields and attributes for tailoring workflow to specific team needs
- Multi-project support with individual configurations per project
- REST API for integration with external tools and custom development

## Use cases

- Software development teams implementing Scrum methodology with sprint planning and tracking
- Product teams managing feature backlogs and roadmaps with epic hierarchies
- Marketing and creative teams using Kanban boards for campaign and content workflows
- Consultancies managing multiple client projects with separate workspaces and permissions
- Organizations migrating from proprietary tools like Jira while maintaining project history
- Remote teams requiring real-time collaboration and progress visibility
- Companies needing custom agile workflows beyond standard Scrum or Kanban practices

## Prerequisites

- Docker and Docker Compose installed with at least 2GB available RAM for all services
- Port 9000 available for the Taiga frontend interface
- Environment variables configured for DB_PASSWORD and SECRET_KEY
- Basic understanding of agile methodologies (Scrum/Kanban) for effective usage
- PostgreSQL knowledge helpful for database maintenance and backup procedures
- Domain name or reverse proxy configuration for production deployments beyond localhost

## docker-compose.yml

```yaml
services:
  taiga-back:
    image: taigaio/taiga-back:latest
    container_name: taiga-back
    restart: unless-stopped
    environment:
      POSTGRES_HOST: db
      POSTGRES_DB: taiga
      POSTGRES_USER: taiga
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      TAIGA_SECRET_KEY: ${SECRET_KEY}
      TAIGA_SITES_DOMAIN: "localhost:9000"
      TAIGA_SITES_SCHEME: "http"
    volumes:
      - taiga_static:/taiga-back/static
      - taiga_media:/taiga-back/media
    depends_on:
      - db
      - rabbitmq

  taiga-front:
    image: taigaio/taiga-front:latest
    container_name: taiga-front
    restart: unless-stopped
    environment:
      TAIGA_URL: "http://localhost:9000"
      TAIGA_WEBSOCKETS_URL: "ws://localhost:9000"
    ports:
      - "9000:80"
    depends_on:
      - taiga-back

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

  rabbitmq:
    image: rabbitmq:3-management-alpine
    container_name: taiga-rabbitmq

volumes:
  taiga_static:
  taiga_media:
  taiga_db:
```

## .env

```bash
DB_PASSWORD=changeme
SECRET_KEY=generate-long-random-key
```

## Usage notes

- Docs: https://docs.taiga.io/
- Access at http://localhost:9000 - register first user as admin
- Scrum: epics, user stories, sprints, burndown charts
- Kanban: swimlanes, WIP limits, cumulative flow
- Import from Trello, Jira, GitHub, Asana
- Customizable attributes, roles, and permissions

## Troubleshooting

- taiga-front shows connection errors: Verify TAIGA_URL and TAIGA_WEBSOCKETS_URL match your actual domain and protocol
- taiga-back fails to start with database connection errors: Check that DB_PASSWORD environment variable matches between taiga-back and db services
- Real-time notifications not working: Ensure rabbitmq container is running and taiga-back can connect to it
- Static files not loading properly: Verify taiga_static volume is properly mounted and taiga-back has write permissions
- First user registration fails: Confirm SECRET_KEY environment variable is set and consistent across restarts
- Import from external tools fails: Check that taiga-back has sufficient memory allocated and TAIGA_SITES_DOMAIN is correctly configured

