Free. Open Source. Powerful. Taiga is a project management platform for startups and agile developers & designers who want a simple, beautiful tool that makes work truly enjoyable.

Taiga Agile

Version: 6 Lynx lynx

Installation Guide

This section details everything you need to know to get Taiga up and running in production environments.

Setup Production Environment with Docker [Recommended]

This document contains the complete tutorial for installation with docker of how to properly setup Taiga for a low traffic production environment.

Previous installation guide

You can access the older docker installation guide for documentation purposes, intended just for earlier versions of Taiga (prior to ver. 6.6.0)

Setup Production Environment from Source Code

This document contains the complete, step by step tutorial of how to properly setup Taiga for a low traffic production environment.

Setup FAQs and common Bugs

You can view a list of common FAQs and bugs related to the setup process FAQs and common bugs.

Upgrading Guide

This section links different upgrade methods depending on your Taiga:

[Docker] Upgrade Taiga6

This section shows how to keep your taiga-docker instance up to date with the new releases.

Recommended If you’re already using taiga-docker, follow this migration guide to use the new .env based deployment.

[Source code] Upgrade from Taiga5 to Taiga6

Update your Taiga5 instance to a new Taiga6 version. This section covers different upgrade scenarios:

  • from Taiga5 source code to Taiga6 in docker

  • from Taiga5 in docker to Taiga6 in docker

  • from Taiga5 source code to Taiga6 source code

[Source code] Older versions

Update between versions.

Backup and Restore Taiga

How to backup and restore Taiga6.

Development

This section details everything you need to know to get Taiga up and running in development environments.

Setup Development Environment

You can view the complete documentation on how to setup a proper development environment.

API

Taiga has a complete REST API (the one used by the web app), check the full API documentation here.

Importers

Checkout the documentation about how to import a project from Github, from Jira, or from Trello.

If you’re using a self-hosted Taiga, check the documentation to integrate them in your instance.

Webhooks

Taiga has a webhook notification system, to easily integrate with third party systems.

Check the documentation about how to configure webhooks or the detailed webhooks payload if you’d like to integrate your own system with Taiga webhooks.

Integrations

You can integrate Taiga with:

Repositories

Chats

Contribute to Taiga

Because Taiga is an open source project, we gratefully accept contributions in various forms. There are many different ways to contribute to Taiga’s platform, from patches, to documentation and UI enhancements, just find the one that best fits with your skills. Check out our detailed contribution guide if you’d like to support Taiga.

Contrib Plugins

Taiga supports the inclusion of contrib plugins, and the community has developed a fair bunch of them, adding different functionalities round Taiga. You can check the list of contributions as well as a detailed tutorial on the many ways to extend Taiga.

Themes

Taiga support themes: it allows customizing app colors and overwriting or adding CSS to any part of Taiga.

Duplicate the folder taiga (or another theme) under /app/themes and rename it with the theme name.

You’ll find two files inside:

  • variables.scss - to override sass variables, fonts, mixins helpers, etc.

  • custom.scss - to override any defined Taiga style for any module or layout.

Remember, the file variables.scss should only contain sass declarations that do not generate code by themselves (like variables or mixins).

If you need to override a style and generate some new CSS, you should do it in custom.scss.

Please, check the default Taiga theme to understand how these files work properly.

Add the theme to the theme array in dist/conf.json.

Deploy your code

gulp deploy

After that, you should be able to update your theme from your user profile in your user settings.

If you create public themes, please share it with the community. Share the link in social media and ping @taigaio.

Community

You can always get in touch with our community through our community space. Feel free to join it and ask any questions you may have.

To subscribe for announcements of releases, important changes and so on, please follow @taigaio on Twitter or read our blog.

License

Every code patch accepted in the Taiga codebase is accepted under the MPL-2 license. It is important that you do not include any code which cannot be licensed under MPL-2.

You can see the complete license in the LICENSE file in the root of the repository.