babim/taiga repository overview

⁠taiga-docker

A small Docker Image for the open-source project management software Taiga.io - compressed image size is 120 MB. The recipe is based on the existing recipe by benhutchins⁠: see https://github.com/benhutchins/docker-taiga⁠ for his approach.

Tested / supported versions of Taiga:

• Version 3.1.0

Thanks: https://hub.docker.com/r/m00re/taiga/⁠

⁠Image details

• The image contains Taiga backend and Taiga frontend.
• Frontend and backend are served by a Nginx server instance running on port 80.
• LDAP plugin from https://github.com/ensky/taiga-contrib-ldap-auth⁠ is integrated and can be enabled if required.
• The Nginx server instance accepts HTTP connections only (no HTTPS), but you can create an own image that enables HTTPS by adjusting the nginx.conf template.
• PostgreSQL database server is not included, i.e. a db server instance is expected to be running elsewhere (either in a different container that is linked, or hosted somewhere else).
• (Open-)LDAP server is not included.
• The image is published on Dockerhub as m00re/taiga

Important environment parameters for configuration:

• TAIGA_HOSTNAME: The name of the server/domain, through which the Taiga instance will be accessed in the end, e.g. taiga.yourdomain.tld (default: localhost).
• TAIGA_SSL: Defines whether the Taiga instance will be accessible through SSL or not, (default: false).
• TAIGA_SECRET_KEY: Defines the secret key used internally by Taiga (default: !!!PLEASE-REPLACE-ME!!!), e.g. for password hashing or similar operations. Please change the default value.
• TAIGA_DB_HOST: Defines the hostname of the server on which the PostgreSQL instance is running (default: localhost).
• TAIGA_DB_NAME: Defines the database name on the PostgreSQL instance (default: postgres).
• TAIGA_DB_USER: Defines the database username for PostgreSQL connections (default: postgres).
• TAIGA_DB_PASSWORD: Defines the password for database connections (default: !!!PLEASE-REPLACE-ME!!!).
• TAIGA_PUBLIC_REGISTER_ENABLED: Defines whether new user registrations are enabled (default: false).
• TAIGA_BACKEND_DEBUG: Enables or disables backend debugging (default: false ).
• TAIGA_FRONTEND_DEBUG: Enables or disables frontend debugging (default: false).
• TAIGA_FEEDBACK_ENABLED: Enables sending of feedback to Taiga.io developers (default: false).
• TAIGA_DEFAULT_LANGUAGE: Defines the default language in the frontend (default: en).
• TAIGA_DEFAULT_THEME: Defines the default theme to be used (default: material-design).
• LDAP_ENABLE: Enables or disables support for LDAP-based authentication (default: false).
• LDAP_SERVER: The hostname or IP address of the LDAP server (default: empty).
• LDAP_PORT: The port on which the LDAP server is listening (default: 389).
• LDAP_BIND_DN: Defines the user to be used for LDAP queries (default: empty).
• LDAP_BIND_PASSWORD: Sets the password of this user (default: empty).
• LDAP_SEARCH_BASE: The base below which to search for user accounts (default: empty).
• LDAP_SEARCH_PROPERTY: The property field to query for when looking up user accounts (default: sAMAccountName).
• LDAP_EMAIL_PROPERTY: The property in which the email address of a user is stored (default: mail).
• LDAP_FULL_NAME_PROPERTY: The property in which the full name of a user is stored (default: displayName).

Important directories inside of the image:

• Backend distribution is located in /taiga.io/taiga-back
• Frontend distribution is located in /taiga.io/taiga-front
• Uploaded media files (e.g. attachments, project logos, profile pcitures) are stored in /taiga.io/taiga-back/media

⁠Example usage with docker-compose

The following docker-compose.yml recipe shows how you can easily start your own Taiga instance, in combination with an own PostgreSQL container image. The important directories of both containers are linked as volumes, for easy backup.

postgres:
  image: babim/postgresql:alpine
  environment:
    - DB_NAME=taiga
    - DB_USER=taiga
    - DB_PASS=taiga123
  volumes:
    - taiga-db:/var/lib/postgresql

taiga:
  image: babim/taiga:all
  ports:
    - 80:80
  links:
    - postgres
  environment:
    - TAIGA_HOSTNAME=localhost
    - TAIGA_DB_HOST=postgres
    - TAIGA_DB_NAME=taiga
    - TAIGA_DB_USER=taiga
    - TAIGA_DB_PASSWORD=taiga123
    - TAIGA_SECRET_KEY=<YOUR_SECRET_KEY_HERE>
    - TAIGA_PUBLIC_REGISTER_ENABLED=true
    - TAIGA_BACKEND_DEBUG=false
    - TAIGA_FRONTEND_DEBUG=false
    - TAIGA_FEEDBACK_ENABLED=false
    - TAIGA_DEFAULT_LANGUAGE=en
    - TAIGA_SSL=false
    - TAIGA_DEFAULT_THEME=material-design
    - LDAP_ENABLE=false
    - AD_ENABLE=false
    - KRB5_ENABLE=false
  volumes:
    - taiga-media:/taiga.io/taiga-back/media

To bring both up, simply type:

docker-compose up -d