/docker-taiga

Taiga-back + taiga-front, served with uWSGI, based on the official Python-Alpine image.

Primary LanguagePythonMIT LicenseMIT

Taiga Docker Image

This is based on the official Python image (Alpine variant) and combines taiga-back and taiga-front components into a single container, which uses uWSGI to serve them both.

Image deprecation

This image is deprecated and will no longer receive updates of the Taiga version. After 1st October 2020, this image won't receive any updates at all, and this repo will be archived. After that date, if the image becomes inactive on Docker Hub, it will be removed as per Docker Hub's image retention policy.

Deployment

Consult Taiga: Setup production environment to learn about external dependencies and basic configuration options. A very basic deployment example can be found in docker-compose.yml and an advanced one in docker-compose.advanced.yml.

Configuring taiga-back

taiga-back can be configured using /etc/opt/taiga-back/settings.py. See root/etc/opt/taiga-back/settings.py in this repository for the default configuration and information about all the settings.

Configuring taiga-front

taiga-front can be configured using /etc/opt/taiga-front/conf.json. See conf.example.json for the default configuration.

Configuring uWSGI

uWSGI can be configured using /usr/local/etc/uwsgi/uwsgi.ini and/or using environmental variables. This file provides only the basic configuration, since settings defined in it cannot be overridden using environmental variables. Also, using environmental variables is the easiest way to extend the default configuration without the need duplicate contents on the configuration file.

See Dockerfile to learn about the variables exported by default and their significance.

Graceful shutdown

With the default configuration, uWSGI is shutdown forcefully on SIGTERM and gracefully on SIGHUP.

Persistence

taiga-back persists data such as attachments in /srv/taiga-back/media. This directory is not a volume by default!

Populate the database with initial data

You can populate the database by using populate-db command. Because this command will overwrite existing data, it is not run by default.

Stability

Breaking changes may occur between different image tags, so make sure to review the changes before upgrading. Images tagged with respective Taiga version are guaranteed to be stable.