Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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
- Host: GitHub
- URL: https://github.com/seanocat/docker-taiga
- Owner: seanocat
- Fork: true (benhutchins/docker-taiga)
- Created: 2016-01-20T02:05:07.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2016-01-20T09:34:25.000Z (almost 9 years ago)
- Last Synced: 2024-08-02T12:48:05.669Z (3 months ago)
- Language: Python
- Homepage: https://hub.docker.com/r/benhutchins/taiga/
- Size: 23.4 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-starred - seanocat/docker-taiga - Docker container for Taiga https://taiga.io (others)
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 wellOr to use this container directly, run:
docker run -itd \
--link taiga-postgres:postgres \
-p 80:80 \
-e TAIGA_HOSTNAME=taiga.mycompany.net \
benhutchins/taigaSee `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:eventsSee 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-eventsdocker 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/taigaAgain, 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`.