Installation

This chapter describes the installation of OTOBO AI. It guides you through the setup process for both the services and the OTOBO package. For further configuration, refer to the specific use case.

There are two components to OTOBO AI:

  1. The services otobo-ai-services.

  2. The otobo-ai OTOBO package.

These installation instructions illustrate their installation.

otobo-ai-services Docker Compose Stack

The otobo-ai-services are provided as self-contained docker compose stack. There are two docker containers:

rag

A Chroma database for vector data and webservice to interface with OTOBO

postgres

A database holding prepared data

The repository may be found here: https://github.com/RotherOSS/otobo-ai-services

First, set up the docker compose project:

cd /opt
git clone git@github.com:RotherOSS/otobo-ai-services.git
cd otobo-ai-services

Create a .env file in the root directory to configure environment variables:

cp .docker_compose_env_ai .env

Edit the .env file to set your desired configuration options.

Use Docker Compose to run the configured services:

docker compose up --detach

OTOBO-AI Package

The package can simply be installed via the OTOBO Package Manager on OTOBO version >= 11.0. See the OTOBO Admin Guide: Package Manager for details on package management in OTOBO.

Configure the package settings in the system configuration. See the OTOBO Admin Guide: System Configuration for general instructions. The package manual includes all relevant information. You may just search OTOBOAI:: to find all relevant settings. These are the basic steps:

  1. Select data for import into the RAG stack (what your answers are based on).

  2. Configure the auth token into the webservice.

  3. Setup the answer template.

Continue depending on your use case with Chat or Retrieval Augmented Generation (RAG).