{"id":13557867,"url":"https://github.com/benhutchins/docker-taiga","last_synced_at":"2025-03-02T02:32:52.759Z","repository":{"id":56414249,"uuid":"41374226","full_name":"benhutchins/docker-taiga","owner":"benhutchins","description":"Docker container for Taiga https://taiga.io","archived":false,"fork":false,"pushed_at":"2020-11-09T13:39:00.000Z","size":57,"stargazers_count":287,"open_issues_count":30,"forks_count":151,"subscribers_count":22,"default_branch":"master","last_synced_at":"2024-08-02T12:48:16.483Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/benhutchins/taiga/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benhutchins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-25T16:17:52.000Z","updated_at":"2024-07-31T06:57:21.000Z","dependencies_parsed_at":"2022-08-15T18:20:10.034Z","dependency_job_id":null,"html_url":"https://github.com/benhutchins/docker-taiga","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benhutchins%2Fdocker-taiga","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benhutchins%2Fdocker-taiga/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benhutchins%2Fdocker-taiga/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benhutchins%2Fdocker-taiga/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benhutchins","download_url":"https://codeload.github.com/benhutchins/docker-taiga/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":220160343,"owners_count":16604041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T12:04:35.575Z","updated_at":"2024-10-17T21:07:40.030Z","avatar_url":"https://github.com/benhutchins.png","language":"Python","funding_links":[],"categories":["Communication and Coordination","Python","Coordination and Communication","others"],"sub_categories":[],"readme":"# What is Taiga?\n\nTaiga is a project management platform for startups and agile developers \u0026 designers who want a simple, beautiful tool that makes work truly enjoyable.\n\n\u003e [taiga.io](https://taiga.io)\n\n# How to use this image\n\nThere 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.\n\n    git clone https://github.com/benhutchins/docker-taiga-example.git mytaiga \u0026\u0026 cd mytaiga\n    vi taiga-conf/local.py # configuration for taiga-back\n    vi taiga-conf/conf.json # configuration for taiga-front\n    vi docker-compose.yml # update environmental variables\n    docker-compose up\n\nOr to use this container directly, run:\n\n    docker run -itd \\\n      --link taiga-postgres:postgres \\\n      -p 80:80 \\\n      -e TAIGA_HOSTNAME=taiga.mycompany.net \\\n      -v ./media:/usr/src/taiga-back/media \\\n      benhutchins/taiga\n\nSee `Summarize` below for a complete example. Partial explanation of arguments:\n\n- `--link` is used to link the database container. See `Configure Database` below for more details.\n\nOnce your container is running, use the default administrator account to login: username is `admin`, and the password is `123123`.\n\nIf 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.\n\n## Extra configuration options\n\nUse the following environmental variables to generate a `local.py` for [taiga-back](https://github.com/taigaio/taiga-back).\n\n  - `-e TAIGA_HOSTNAME=` (**required** set this to the server host like `taiga.mycompany.com`)\n  - `-e TAIGA_SSL=True` (see `Enabling HTTPS` below)\n  - `-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)\n  - `-e TAIGA_SKIP_DB_CHECK` (set to skip the database check that attempts to automatically setup initial database)\n  - `-e TAIGA_ENABLE_EMAIL=True` (see `Configuring SMTP` below)\n\n*Note*: Database variables are also required, see `Using Database server` below. These are required even when using a container for your database.\n\n## Configure Database\n\nThe 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.\n\n### Using Docker container\n\nIf 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.\n\n    docker run --name taiga-postgres -e POSTGRES_PASSWORD=mypassword -d postgres\n\n### Using Database server\n\nUse the following, **required**, environment variables for connecting to another database server:\n\n - `-e TAIGA_DB_NAME=...` (defaults to `postgres`)\n - `-e TAIGA_DB_HOST=...` (defaults to the address of a linked `postgres` container)\n - `-e TAIGA_DB_USER=...` (defaults to `postgres)`)\n - `-e TAIGA_DB_PASSWORD=...` (defaults to the password of the linked `postgres` container)\n\nTaiga will attempt to connect to the DB server for up to TAIGA_DB_CONNECT_TIMEOUT seconds before exiting.\n\nIf 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.\n\nAn example `docker run` command using an external database:\n\n    docker run \\\n      --name mytaiga \\\n      -e TAIGA_DB_HOST=10.0.0.1 \\\n      -e TAIGA_DB_USER=taiga \\\n      -e TAIGA_DB_PASSWORD=mypassword \\\n      -itd \\\n      benhutchins/taiga\n\n## Taiga Events\n\nTaiga 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:\n\n```bash\n# Setup RabbitMQ and Redis services\ndocker run --name taiga-redis -d redis:3\ndocker run --name taiga-rabbit -d --hostname taiga rabbitmq:3\n\n# Start up a celery worker\ndocker run --name taiga-celery -d --link taiga-rabbit:rabbit celery\n\n# Now start the taiga-events server\ndocker run --name taiga-events -d --link taiga-rabbit:rabbit benhutchins/taiga-events\n```\n\nThen append the following arguments to your `docker run` command running your `benhutchins/taiga` container:\n\n    --link taiga-rabbit:rabbit\n    --link taiga-redis:redis\n    --link taiga-events:events\n\nSee the example below in `Summarize` section for an example `docker run` command.\n\n## Enabling HTTPS\n\nIf you want to enable support for HTTPS, you'll need to specify all of these\nadditional arguments to your `docker run` command.\n\n  - `-e TAIGA_SSL=True`\n  - `-v $(pwd)/ssl.crt:/etc/nginx/ssl/ssl.crt:ro`\n  - `-v $(pwd)/ssl.key:/etc/nginx/ssl/ssl.key:ro`\n\nOr create a folder called `ssl`, place your `ssl.crt` and `ssl.key` inside\nthis directory and then mount it with:\n\n  - `-e TAIGA_SSL=True`\n  - `-v $(pwd)/ssl/:/etc/nginx/ssl/:ro`\n\n### HTTPS behind reverse proxies\n\nIf you have a reveser proxy that is already handling https set `TAIGA_SSL_BY_REVERSE_PROXY`:\n\n- `-e TAIGA_SSL_BY_REVERSE_PROXY=True`\n\nThe value of `TAIGA_SSL` will then be ignored and taiga will not handle https,\nit will however set all links to https.\n\n## Configuring SMTP\n\nIf you want to use an SMTP server for emails, you'll need to specify all of\nthese additional arguments to your `docker run` command.\n\n- `-e TAIGA_ENABLE_EMAIL=True`\n- `-e TAIGA_EMAIL_FROM=no-reply@taiga.mycompany.net`\n- `-e TAIGA_EMAIL_USE_TLS=True` (only if you want to use tls)\n- `-e TAIGA_EMAIL_HOST=smtp.google.com`\n- `-e TAIGA_EMAIL_PORT=587`\n- `-e TAIGA_EMAIL_USER=me@gmail.com`\n- `-e TAIGA_EMAIL_PASS=super-secure-pass phrase thing!`\n\n**Note:** This can also be configured directly inside your own config file, look\nat [this example](https://github.com/benhutchins/docker-taiga-example/tree/master/simple)'s\nsetup where it specifies a `taiga-conf/local.py`. You can then configure this\nand other [settings available in Taiga](https://github.com/taigaio/taiga-back/blob/master/settings/local.py.example).\n\n## Volumes\n\nUploads to Taiga go to the media folder, located by default at `/usr/src/taiga-back/media`.\n\nUse `-v /my/own/media:/usr/src/taiga-back/media` as part of your docker run command to ensure uploads are not lost easily.\n\n## Summarize\n\nTo sum it all up, if you want to run Taiga without using docker-compose, run this:\n\n    docker run --name taiga-postgres -d -e POSTGRES_PASSWORD=password postgres\n    docker run --name taiga-redis -d redis:3\n    docker run --name taiga-rabbit -d --hostname taiga rabbitmq:3\n    docker run --name taiga-celery -d --link taiga-rabbit:rabbit celery\n    docker run --name taiga-events -d --link taiga-rabbit:rabbit benhutchins/taiga-events\n\n    docker run -itd \\\n      --name taiga \\\n      --link taiga-postgres:postgres \\\n      --link taiga-redis:redis \\\n      --link taiga-rabbit:rabbit \\\n      --link taiga-events:events \\\n      -p 80:80 \\\n      -e TAIGA_HOSTNAME=$(docker-machine ip default) \\\n      -v ./media:/usr/src/taiga-back/media \\\n      benhutchins/taiga\n\nAgain, 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`.\n\n# Using this git repo\n\nIf you want to get the latest and greatest, you can clone this repo, then update\nTaiga to the latest by running:\n\n```bash\ngit clone https://github.com/benhutchins/docker-taiga.git \u0026\u0026 cd docker-taiga/\ngit submodule update --init --remote\ndocker-compose up -d # this will build and then start taiga locally\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenhutchins%2Fdocker-taiga","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenhutchins%2Fdocker-taiga","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenhutchins%2Fdocker-taiga/lists"}