OTOBO Installation with Docker Compose

OTOBO & Open Ticket AI Installation with Docker Compose

Installing OTOBO using Docker Compose is the most modern and easiest method to manage. In this guide, we will show you how to deploy the OTOBO core system together with the Open Ticket AI Runtime (OTAI) in a shared stack.

Prerequisites

Before you begin, ensure that the following components are installed on your server:

• Docker (>= 20.10)
• Docker Compose (>= 2.10)
• At least 4 GB RAM (8 GB recommended for Elasticsearch and AI models)
• Internet access to download the images

Step 1: Create project directory

Create a new directory for your OTOBO installation:

mkdir -p /opt/otobo-docker
cd /opt/otobo-docker

Step 2: Configure Docker Compose file

Download the official OTOBO Docker Compose configuration or create your own. To integrate the Open Ticket AI Runtime, we add the otai-runtime service.

Example docker-compose.yml

Here is an example of a combined stack:

version: '3.8'

services:
  otobo-db:
    image: mariadb:10.5
    restart: always
    environment:
      - MYSQL_ROOT_PASSWORD=your_root_password
      - MYSQL_DATABASE=otobo
      - MYSQL_USER=otobo
      - MYSQL_PASSWORD=your_otobo_password
    volumes:
      - otobo_db_data:/var/lib/mysql

  otobo-web:
    image: rotheross/otobo:latest
    restart: always
    depends_on:
      - otobo-db
      - otobo-redis
      - otobo-elastic
    environment:
      - OTOBO_DB_ROOT_PASSWORD=your_root_password
    ports:
      - "80:5000"
    volumes:
      - otobo_web_data:/opt/otobo

  otobo-redis:
    image: redis:6.0
    restart: always

  otobo-elastic:
    image: elasticsearch:7.10.2
    restart: always
    environment:
      - discovery.type=single-node

  # --- Open Ticket AI Runtime ---
  otai-runtime:
    image: softoft/otai-runtime:latest # Official OTAI image
    container_name: otai-runtime
    restart: always
    environment:
      - OTAI_API_KEY=your_otai_api_key # Available at openticketai.com
      - OTAI_BACKEND_URL=http://otobo-web:5000/otobo/nph-genericinterface.pl/Webservice/OTAI
      - DEVICE=cpu # 'cuda' if GPU is available
    depends_on:
      - otobo-web
    networks:
      - default

volumes:
  otobo_db_data:
  otobo_web_data:

[!TIP] You will receive the OTAI_API_KEY after registering at openticketai.com.

Step 3: Start the system

Run the following command to start the containers in the background:

docker-compose up -d

Check the status of the containers:

docker-compose ps

Step 4: Complete OTOBO Web-Installer

After the containers have started successfully, you can access the OTOBO Web-Installer via your browser:

http://your-server-ip/otobo/installer.pl

Follow the instructions in the installer to configure the database connection and basic system settings.

Step 5: Open Ticket AI Integration (OTAI)

Once OTOBO is running, the Open Ticket AI Runtime is already active in the background. To use the AI features (such as automatic queue assignment or prioritization), you must import the OTAI Webservice into OTOBO.

1. Go to Admin > Webservices.
2. Import the configuration file for OTAI (available in the Softoft customer area).
3. Test the connection to the otai-runtime using the integrated debugger.

---

Further tips

• GPU Support: If you have an NVIDIA GPU, you can configure the otai-runtime service to use CUDA to significantly accelerate classification.
• Backups: Regularly back up the Docker volumes otobo_db_data and otobo_web_data.
• Updates: You can perform an update simply by running docker-compose pull && docker-compose up -d.

For professional support with installation or integration, please contact Softoft.de.