Skip to content

Taiga App

About

Taiga is the project management tool for multi-functional agile teams.

Custom configuration

Taiga customizations are placed in two files:

  • conf.json - This contains UI settings. On the Cloudron app, this file is located at /app/data/conf.json.

  • local.py - This contains backend settings. On the Cloudron app, this file is located at /app/data/customlocal.py. The default settings are listed in the common.py file.

These customizations will persist across updates and restarts.

To edit these files use the File manager.

Disabling external registration

When using Cloudron auth, external registration is already disabled. When now using Cloudron auth, edit the following files using File manager.

  • PUBLIC_REGISTER_ENABLED = False in /app/data/customlocal.py
  • "publicRegisterEnabled": false in /app/data/conf.json

Importing a project

An existing project's json can be imported into Taiga as follows:

  • Connect to taiga using the Web terminal
  • Upload the project.json using the 'Upload to /tmp' button
  • su cloudron
  • source /app/code/taiga/bin/activate
  • cd /app/code/taiga-back
  • python manage.py load_dump /tmp/project.json email@domain.tld

Asana

To import projects from Asana:

  • Create an Asana Connect client and secret. The redirect URL must be set to https://taiga.example.com/project/new/import/asana

  • Edit the backend config at /app/data/customlocal.py to contain the key:

IMPORTERS["asana"] = {
    "active": True, # Enable or disable the importer
    "callback_url": "{}://{}/project/new/import/asana".format(SITES["front"]["scheme"],
                                                              SITES["front"]["domain"]),
    "app_id": "client id from above",
    "app_secret": "client secret from above"
}
  • Edit /app/data/conf.json:
  "importers": [
    "asana"
  ]
  • Restart the app

Plugins

Slack

The slack plugin is installed but not enabled. To enable it, add the following line to /app/data/customlocal.py:

INSTALLED_APPS += ["taiga_contrib_slack"]

Enable the frontend of Slack plugin by editing /app/data/conf.json:

    "contribPlugins": [ "/plugins/slack/slack.json" ]

Then, initialize the database by running the following command in the web terminal:

source /app/code/taiga/bin/activate
cd /app/code/taiga-back
python manage.py migrate taiga_contrib_slack

Be sure to restart the app for the changes to take effect.