Currently, we have authored three main documentation hubs:
- API: Our API documentation and reference for developing from Taiga API.
- Documentation: If you need to install Taiga on your own server, this is the place to find some guides.
- Taiga Resources: This page is intended to be the support reference page for the users.
The easiest way to run Taiga is using Docker and Docker Compose:
docker-compose upThis will start all the required services (PostgreSQL, RabbitMQ, and Taiga backend).
If you prefer to run Taiga without Docker, follow these steps:
- Python 3.8+
- PostgreSQL 12
- RabbitMQ 3.8+
- pip and virtualenv
-
Create and activate a virtual environment:
python -m venv taiga-env source taiga-env/bin/activate # On Windows: taiga-env\Scripts\activate
-
Install dependencies:
pip install -r requirements.txt
-
Set up PostgreSQL:
Create a PostgreSQL database for Taiga:
createuser taiga createdb taiga -O taiga
Set a password for the taiga user:
psql -c "ALTER USER taiga WITH PASSWORD 'taiga';" -
Configure Taiga:
Create a configuration file by copying the example:
cp settings/config.py.dev.example settings/config.py
Edit the
settings/config.pyfile to match your environment, particularly the database settings:DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'taiga', 'USER': 'taiga', 'PASSWORD': 'taiga', 'HOST': 'localhost', 'PORT': '5432', } }
If you're using RabbitMQ for events and async tasks, configure the RabbitMQ settings:
EVENTS_PUSH_BACKEND = "taiga.events.backends.rabbitmq.EventsPushBackend" EVENTS_PUSH_BACKEND_OPTIONS = { "url": "amqp://taiga:taiga@localhost:5672/taiga" } CELERY_ENABLED = True CELERY_BROKER_URL = "amqp://taiga:taiga@localhost:5672/taiga"
-
Initialize the database:
python manage.py migrate python manage.py loaddata initial_user python manage.py loaddata initial_project_templates python manage.py compilemessages python manage.py collectstatic --noinput
-
Create a superuser (admin):
python manage.py createsuperuser
-
Run the development server:
python manage.py runserver
The Taiga API will be available at http://localhost:8000/api/v1/
-
For production environments:
For production use, you should:
- Use a proper WSGI server like Gunicorn
- Set up a reverse proxy with Nginx
- Configure SSL
- Set DEBUG=False in your settings
Example with Gunicorn:
pip install gunicorn gunicorn --workers=4 --timeout=60 --log-level=info --access-logfile=- --error-logfile=- taiga.wsgi
If you've enabled Celery for asynchronous tasks, you'll need to run the Celery worker:
celery -A taiga worker -l infoIf you find a bug in Taiga you can always report it:
- in Taiga issues. This is the preferred way
- in Github issues
- send us a mail to support@taiga.io if is a bug related to tree.taiga.io
- send us a mail to security@taiga.io if is a security bug
One of our fellow Taiga developers will search, find and hunt it as soon as possible.
Please, before reporting a bug, write down how can we reproduce it, your operating system, your browser and version, and if it's possible, a screenshot. Sometimes it takes less time to fix a bug if the developer knows how to find it.
If you need help to setup Taiga, want to talk about some cool enhancemnt or you have some questions, please go to Taiga community.
If you want to be up to date about announcements of releases, important changes and so on, you can subscribe to our newsletter (you will find it by scrolling down at https://taiga.io) and follow @taigaio on Twitter.
There are many different ways to contribute to Taiga's platform, from patches, to documentation and UI enhancements, just find the one that best fits with your skills. Check out our detailed contribution guide
Help us keep the Taiga Community open and inclusive. Please read and follow our Code of Conduct.
Every code patch accepted in Taiga codebase is licensed under MPL 2.0. You must be careful to not include any code that can not be licensed under this license.
Please read carefully our license and ask us if you have any questions as well as the Contribution policy.