fanningert/docker-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.2.2

⁠Available Docker Images at DockerHub

See: https://hub.docker.com/r/fanningert/docker-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 fanningert/docker-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: postgres:9.6.1-alpine
  environment:
    - POSTGRES_DB=taiga
    - POSTGRES_USER=taiga
    - POSTGRES_PASSWORD=3MwR95cj9YAP7zm2lKrU
  volumes:
    - taiga-db:/var/lib/postgresql/data

taiga:
  image: fanningert/docker-taiga
  ports:
    - 80:80
  links:
    - postgres
  environment:
    - TAIGA_HOSTNAME=localhost
    - TAIGA_DB_HOST=postgres
    - TAIGA_DB_NAME=taiga
    - TAIGA_DB_USER=taiga
    - TAIGA_DB_PASSWORD=3MwR95cj9YAP7zm2lKrU
    - 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=de
    - TAIGA_SSL=false
    - TAIGA_DEFAULT_THEME=material-design
    - LDAP_ENABLE=false
  volumes:
    - taiga-media:/taiga.io/taiga-back/media

To bring both up, simply type:

docker-compose up -d