Skip to content

Latest commit

 

History

History
103 lines (65 loc) · 3.73 KB

INSTALL-APP.md

File metadata and controls

103 lines (65 loc) · 3.73 KB

TAIGA APP Installation

The application can be installed either within the BIBBOX environment or as a stand-alone solution. Installation instructions can be found within the BIBBOX, followed by setup instructions required once the application has been successfully installed.

Installation within in the BIBBOX

Once you've selected the desired App for your BIBBOX instance, you can choose from the available versions, as shown in the following figure.

Screenshot01

Clicking "Install App" will open a new window, as illustrated in the following figure. Here, you can define the necessary entries. Some fields come pre-filled with suggested options, and if left unchanged, these default values will be used as the entries.

Screenshot02

After confirming by clicking "Install," the App will be installed as a BIBBOX instance. Once the installation is complete, you only need to follow a few steps to use the App for the first time, which are described below.

Setup after BIBBOX or stand-alone installation

Standalone

Login:

  • user: admin
  • password: vendetta

Please change the password.

BIBBOX

  • User and password was set during installation

Add new users

Once a new user is added to a project a email notifictaion is automatically send to the provided email address.

  • Create a project -> settings -> members -> +NEW MEMBER

If Email is disabled.

Add the user to the project in the same way:

  • Create a project -> settings -> members -> +NEW MEMBER

No Email will/can be send. You can check the Postgres database for the invitation token of that member in the table projects_memberships (Using adminer or a similar app). Once you have the token you can share the invitatio link with the new member:

Configration

Email

Standalone

Default disabled. Can be changed in the docker-compose.yml file: Uncomment following lines and configure your SMTP server

  • EMAIL_BACKEND: "django.core.mail.backends.smtp.EmailBackend"
  • DEFAULT_FROM_EMAIL: "[email protected]"
  • EMAIL_USE_TLS: "False"
  • EMAIL_USE_SSL: "False"
  • EMAIL_HOST: "smtp.host.example.com"
  • EMAIL_PORT: 587
  • EMAIL_HOST_USER: "user"
  • EMAIL_HOST_PASSWORD: "password"

If taiga was already running you need to restart it after the chnages are saved:

  • docker-compose down
  • docker-compose up -d

BIBBOX

  • Set during installation

HTTP / HTTPS

Standalone

On default is the standalone version running on http. This can be changed in the docker-compose.yml file by changing the corresponding environment variables to https and wss respectively.

  • TAIGA_SITES_SCHEME: "https"
  • TAIGA_URL: "https://localhost:9000"
  • TAIGA_WEBSOCKETS_URL: "wss://localhost:9000"

If taiga was already running you need to restart it after the chnages are saved:

  • docker-compose down
  • docker-compose up -d

BIBBOX

On default is the BIBBOX version running on http. This can be changed in the docker-compose.yml file by changing the corresponding environment variables to http and ws respectively.

  • TAIGA_SITES_SCHEME: "http"
  • TAIGA_URL: "http://§§INSTANCE.§§BASEURL"
  • TAIGA_WEBSOCKETS_URL: "ws://§§INSTANCE.§§BASEURL"

If taiga was already running you need to restart it after the chnages are saved:

  • docker-compose down
  • docker-compose up -d

You might also need to restart the bibbox proxy:

  • docker exec bibbox-sys-commander-apacheproxy httpd -k graceful or docker exec bibbox-sys-commander-apacheproxy apache2ctl -k graceful

After the installation

Have a nice ride with the new Admins youngtimer.

FINAL