Installation guide

If you are a tech enthusiast with the ability to self-install and maintain your instance, Tuleap Community Edition (TCE) is available and offer powerful capabilities for non-critical business process or development needs. If you need enterprise-class features, scalability and security and if you plan to use Tuleap in a production environment, you should consider Tuleap Enterprise Edition.

This document aims to help you install Tuleap Community Edition (TCE) or Tuleap Enterprise Edition (TEE) on your server.

Multiple ways to install TCE & TEE are supported with their benefits and disadvantages.

• Docker installation:

  • Quick and easy install

  • Recommended way to install Tuleap, especially for tests

• Step by step installation:

  • Fully adaptable to your needs

  • Installation can be tricky for linux beginners

• Ansible installation:

  • Require an ansible client

  • Quick and easy install

  • Deploy and manage multiple servers at once

  • A first default setup is done with ansible

Table of contents:

• Docker installation
  • Introduction - Tuleap on Docker
  • Docker images configuration
  • Verify the image authenticity
  • Docker Standalone
  • Docker Compose
• Step by step Installation
  • Requirements
  • Install dependencies
  • Install packages - Tuleap Community Edition
  • Install packages - Tuleap Enterprise Edition
  • Prepare the database
  • Setup
  • TLS configuration
  • Mail configuration
  • Redis Configuration
  • First connection
  • Plugins installation
  • Upgrade
• Ansible Installation
  • Requirements
  • Ansible Role
  • Installation
• Troubleshooting
  • I can not access Tuleap front page
  • I have a blank page when accessing a web page
  • I can not log in or I’m redirected indefinitely on the login page
  • Backend workers are not processing the system events
  • I checked everything and it’s still not working