zeigerpuppy / taiga

docker-compose.yml for simple taiga setup

Taiga docker setup

About

This is example Docker Compose file for running Taiga project management platform for agile developers, designers and project managers with taiga-events and ssl-enabled reverse proxy with all images based on alpine:latest.

Basic usage

1. Clone this repository. git clone --depth=1 -b master https://github.com/docker-taiga/taiga.git
2. Adjust TAIGA_HOST, TAIGA_SECRET, POSTGRES_PASSWORD, RABBIT_PASSWORD and REDIS_PASSWORD in variables.env file.
3. (Optional) If you want to enable SSL, change TAIGA_SCHEME and TAIGA_PORT variables accordingly, create cert folder and put ssl certificate and key inside. Default certificate and key filenames are fullchain.pem and privkey.pem. This can be changed by adding CERT_NAME and CERT_KEY environment variables to the service proxy. Alternatively, if you use certbot to acquire certificates, point volume /taiga-cert of the proxy service to the location of certificates, e.g. /etc/letsencrypt/live/yourdomain.com.
4. docker-compose up

The default username and password taiga creates is admin with password 123123.

Individual images

• Taiga backend https://github.com/docker-taiga/back docker pull dockertaiga/back
• Taiga frontend https://github.com/docker-taiga/front docker pull dockertaiga/front
• RabbitMQ server https://github.com/docker-taiga/rabbit docker pull dockertaiga/rabbit
• Taiga events https://github.com/docker-taiga/events docker pull dockertaiga/events
• Nginx reverse proxy https://github.com/docker-taiga/proxy docker pull dockertaiga/proxy

Environment variables

• TAIGA_HOST - Taiga hostname to use with this taiga setup.
• TAIGA_SCHEME - Taiga URL scheme (http/https). Default is 'http'.
• TAIGA_PORT - Taiga port to use. Default is 80.
• TAIGA_BACK_HOST - Backend hostname. Default is back service.
• TAIGA_FRONT_HOST - Frontend hostname. Default is front service.
• EVENTS_HOST - Events hostname. Default is events service.
• TAIGA_SECRET - Django secret key.

---

• ENABLE_SSL - Enable SSL termination (yes/no). Default is 'no'.
• CERT_NAME - Name of certificate file. Default is fullchain.pem.
• CERT_KEY - Name of certificate key file. Default is privkey.pem.

---

• POSTGRES_HOST - PostgeSQL hostname. Default is db service.
• POSTGRES_DB - Database name.
• POSTGRES_USER - PostgreSQL username.
• POSTGRES_PASSWORD - PostgreSQL password.

---

• RABBIT_HOST - RabbitMQ hostname. Default is rabbit service.
• RABBIT_USER - RabbitMQ username.
• RABBIT_PASSWORD - RabbitMQ password.
• RABBIT_VHOST - RabbitMQ virtual host name.

---

• REDIS_HOST - Redis hostname. Default is redis service.
• REDIS_PASSWORD - Redis password.
• REDIS_DB - Redis database index.

Configuration

By default configuration volume is ./conf with config files ./conf/back/config.py for backend, ./conf/front/config.json for frontend and ./conf/proxy/nginx.conf for reverse proxy. Generated config files are placed here on first run and can be modified to specify e.g. SMTP server configuration.

Persistence

Volume ./data contains postgresql data and taiga media files for persistence and backup purposes.

Upgrading

Before upgrading be sure to check taiga-back changelog for any breaking changes and check for any modified configuration files in this repo to see what configs need to be adjusted accordignly.

1. Update image versions in docker-compose.yml or pull from this repo.
2. docker-compose pull
3. docker-compose up