Skip to content

How to setup Taiga (with Docker & Caddy)

Untested

Description

Taiga is a free and open-source project management system for startups, agile developers, and designers.

Create a DNS record

Go to cPanel and add a new record (e.g. taiga.akdscloud.eu).

Caddy

taiga.akdscloud.eu:443 {
    header Strict-Transport-Security max-age=31536000;
    reverse_proxy localhost:9003
}

Download the repo

Go to the official docker Github page and download the repo.

Docker configuration

Unzip the repo and start editing .env file from inside.

You need to change the default values of the following variables:

  • TAIGA_SCHEME (change to https)
  • TAIGA_DOMAIN (taiga.yourdomain.com)
  • WEBSOCKETS_SCHEME (change to wss)
  • SECRET_KEY (generate with openssl rand -hex 20 and remove the quotes)
  • POSTGRES_PASSWORD (generate with openssl rand -hex 20)
  • RABBITMQ_PASS (generate with openssl rand -hex 20)
  • RABBITMQ_ERLANG_COOKIE (generate with openssl rand -base64 24)

Here is an example:

TAIGA_SCHEME=http  # serve Taiga using "http" or "https" (secured) connection
TAIGA_DOMAIN=localhost:9000  # Taiga's base URL
WEBSOCKETS_SCHEME=ws  # events connection protocol (use either "ws" or "wss")

SECRET_KEY="taiga-secret-key"  # Please, change it to an unpredictable value!

POSTGRES_PASSWORD=taiga  # database user's password

RABBITMQ_PASS=taiga  # RabbitMQ user's password
RABBITMQ_ERLANG_COOKIE=secret-erlang-cookie  # unique value shared by any connected instance of RabbitMQ

TAIGA_SCHEME=https  # serve Taiga using "http" or "https" (secured) connection
TAIGA_DOMAIN=taiga.akdscloud.eu  # Taiga's base URL
WEBSOCKETS_SCHEME=wss  # events connection protocol (use either "ws" or "wss")

SECRET_KEY=150a13b6379ecb1b9d058ed28a78bdfa345aefd8  # Please, change it to an unpredictable value!

POSTGRES_PASSWORD=9475ca8e510e54ac6369dc416a57715086e880fa  # database user's password

RABBITMQ_PASS=0f75f9724711879f6adac7c38085d445d01e0341  # RabbitMQ user's password
RABBITMQ_ERLANG_COOKIE=ix2PYQSpLGKlEvUgNzMLUKBrm+yeh3iT  # unique value shared by any connected instance of RabbitMQ

Download and start taiga:

```bash
cd ~/services/taiga-docker-main
docker compose up -d
```

Restart Caddy to get an SSL certificate (details here)

Configuration

Create an admin user

docker compose -f docker-compose.yml -f docker-compose-inits.yml run --rm taiga-manage createsuperuser

Enter the required data (username, email and password).

Try it out

See if you can access the taiga web interface.

If you can, also make sure you can log in with the admin user you just created.

Troubleshooting

If it doesn't work, see the troubleshooting guide.

Creating non-admin users

By default, public registration is disabled.
In order to create a new (regular) user, you will have to temporarily enable public registration.

Open the docker-compose-.yml file and add the following:

Add to &default-back-environment environments

PUBLIC_REGISTER_ENABLED: "True"

Add to taiga-front service environments

PUBLIC_REGISTER_ENABLED: "true"

cd ~/services/taiga-docker-main
docker compose down
docker compose up -d

Open the web interface and see if you can Sign up (i.e. register a new user).

After creating the new user, disable public registration again by removing the values above and doing another docker compose down && docker compose up -d.

Official site

https://docs.taiga.io/setup-production.html