Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/seanocat/docker-taiga

Docker container for Taiga https://taiga.io
https://github.com/seanocat/docker-taiga

Last synced: 4 days ago
JSON representation

Docker container for Taiga https://taiga.io

Awesome Lists containing this project

README 

        
# What is Taiga?



Taiga is a project management platform for startups and agile developers & designers who want a simple, beautiful tool that makes work truly enjoyable.



> [taiga.io](https://taiga.io)



# About this image



This image is a slightly modified version from [benhutchins/docker-taiga](https://github.com/benhutchins/docker-taiga) in order to support taiga-events in SSL terminated reverse proxy environment.



# How to use this image



There is also an updated version of example project at [seanocat/docker-taiga-example](https://github.com/seanocat/docker-taiga-example).



# Original README.md from [benhutchins/docker-taiga](https://github.com/benhutchins/docker-taiga)



There is an example project available at [benhutchins/docker-taiga-example](https://github.com/benhutchins/docker-taiga-example) that provides base configuration files available for you to modify and allows you to easily install plugins. I recommend you clone this repo and modify the files, then use it's provided scripts to get started quickly.



    git clone https://github.com/benhutchins/docker-taiga-example.git mytaiga && cd mytaiga

    vi taiga-conf/local.py # configuration for taiga-back

    vi taiga-conf/conf.json # configuration for taiga-front

    TAIGA_HOSTNAME=taiga.mycompany.com ./start.sh --with-events

    # docker-compose up # There is a provided docker compose configuration file as well



Or to use this container directly, run:



    docker run -itd \

      --link taiga-postgres:postgres \

      -p 80:80 \

      -e TAIGA_HOSTNAME=taiga.mycompany.net \

      benhutchins/taiga



See `Summarize` below for a complete example. Partial explanation of arguments:



- `--link` is used to link the database container. See `Configure Database` below for more details.



Once your container is running, use the default administrator account to login: username is `admin`, and the password is `123123`.



If you're having trouble connecting, make sure you've configured your `TAIGA_HOSTNAME`. It will default to `localhost`, which almost certainly is not what you want to use.



## Extra configuration options



Use the following environmental variables to generate a `local.py` for [taiga-back](https://github.com/taigaio/taiga-back).



  - `-e TAIGA_HOSTNAME=` (**required** set this to the server host like `taiga.mycompany.com`)

  - `-e TAIGA_SSL=True` (see `Enabling HTTPS` below)

  - `-e TAIGA_SECRET_KEY` (set this to a random string to configure the `SECRET_KEY` value for taiga-back; defaults to an insecure random string)

  - `-e TAIGA_SKIP_DB_CHECK` (set to skip the database check that attempts to automatically setup initial database)



## Configure Database



The above example uses `--link` to connect Taiga with a running [postgres](https://registry.hub.docker.com/_/postgres/) container. This is probably not the best idea for use in production, keeping data in docker containers can be dangerous.



### Using Docker container



If you want to run your database within a docker container, simply start your database server before starting your Taiga container. Here is a simple example pulled from [postgres](https://registry.hub.docker.com/_/postgres/)'s guide.



    docker run --name taiga-postgres -e POSTGRES_PASSWORD=mypassword -d postgres



### Using Database server



You can use the following environment variables for connecting to another database server:



 - `-e TAIGA_DB_NAME=...` (defaults to `postgres`)

 - `-e TAIGA_DB_HOST=...` (defaults to the address of a linked `postgres` container)

 - `-e TAIGA_DB_USER=...` (defaults to `postgres)`)

 - `-e TAIGA_DB_PASSWORD=...` (defaults to the password of the linked `postgres` container)



If the `TAIGA_DB_NAME` specified does not already exist on the provided PostgreSQL server, it will be automatically created the the Taiga's installation scripts will run to generate the required tables and default demo data.



An example `docker run` command using an external database:



    docker run \

      --name mytaiga \

      -e TAIGA_DB_HOST=10.0.0.1 \

      -e TAIGA_DB_USER=taiga \

      -e TAIGA_DB_PASSWORD=mypassword \

      -itd \

      benhutchins/taiga



## Taiga Events



Taiga has an optional dependency, [taiga-events](https://github.com/taigaio/taiga-events). This adds additional usability to Taiga. To support this, there is an optional docker dependency available called [docker-taiga-events](https://github.com/benhutchins/docker-taiga-events). It has a few dependencies of its own, so this is how you run it:



```bash

# Setup RabbitMQ and Redis services

docker run --name taiga-redis -d redis:3

docker run --name taiga-rabbit -d --hostname taiga rabbitmq:3



# Start up a celery worker

docker run --name taiga-celery -d --link taiga-rabbit:rabbit celery



# Now start the taiga-events server

docker run --name taiga-events -d --link taiga-rabbit:rabbit benhutchins/taiga-events

```



Then append the following arguments to your `docker run` command running your `benhutchins/taiga` container:



    --link taiga-rabbit:rabbit

    --link taiga-redis:redis

    --link taiga-events:events



See the example below in `Summarize` section for an example `docker run` command.



## Enabling HTTPS



If you want to enable support for HTTPS, you'll need to specify all of these additional arguments to your `docker run` command.



  - `-e TAIGA_SSL=True`

  - `-v $(pwd)/ssl.crt:/etc/nginx/ssl/ssl.crt:ro`

  - `-v $(pwd)/ssl.key:/etc/nginx/ssl/ssl.key:ro`



If you're using an older version of Docker, or using boot2docker or Docker Machine, you may need to mount `/etc/nginx/ssl/` as a shared volume directory. Create a folder called `ssl`, place your `ssl.crt` and `ssl.key` inside this directory and then mount it with:



    -v $(pwd)/ssl/:/etc/nginx/ssl/:ro



## Summarize



To sum it all up, if you want to run Taiga without using



    docker run --name taiga-postgres -d -e POSTGRES_PASSWORD=password postgres

    docker run --name taiga-redis -d redis:3

    docker run --name taiga-rabbit -d --hostname taiga rabbitmq:3

    docker run --name taiga-celery -d --link taiga-rabbit:rabbit celery

    docker run --name taiga-events -d --link taiga-rabbit:rabbit benhutchins/taiga-events



    docker run -itd \

      --name taiga \

      --link taiga-postgres:postgres \

      --link taiga-redis:redis \

      --link taiga-rabbit:rabbit \

      --link taiga-events:events \

      -p 80:80 \

      -e TAIGA_HOSTNAME=$(docker-machine ip default) \

      benhutchins/taiga



Again, you can avoid all this by using [benhutchins/docker-taiga-example](https://github.com/benhutchins/docker-taiga-example) and then just run `docker-compose up`.